VIRole Category | Vmware PowerCLI Reference

VI Role Category

Cmdlets are usually implemented around resource operations. The four basic operations are CREATE, READ, UPDATE and DELETE. This set of operations is known as CRUD. Most of the cmdlets support CRUD which are respectively cmdlets that start with the New/Get/Set/Remove cmdlet verbs but they also may have additional operations

Step 1: Retrieve a object by running a Get command

You can READ objects by using Get-VIRole cmdlet. See example below:

# Retrieves all roles on the specified server with names that start with "Admin".

Get-VIRole -Server $server -Name "Admin*"

Step 2 : Run commands from the CRUD group

You can CREATE objects by using New-VIRole cmdlet. See example below:

# Creates a new role with the provided group privileges.

New-VIRole -Name Role -Privilege (Get-VIPrivilege -PrivilegeGroup)
You can UPDATE objects by using Set-VIRole cmdlet. See example below:

# Adds the "Create Datacenter" privilege to the Role role.

Set-VIRole -Role Role -AddPrivilege (Get-VIPrivilege -Name 'Create Datacenter')
You can REMOVE objects by using Remove-VIRole cmdlet. See example below:

# Removes the roles with names that start with "Customer".

Get-VIRole -Server $server -Name "Customer*" | Remove-VIRole