---

NAME
Set-VIRole

SYNOPSIS
Modifies the privileges of the provided roles.

SYNTAX
Set-VIRole [-Role] [-Name ] [-AddPrivilege ] [-Server ] [-WhatIf] [-Confi
rm] []

Set-VIRole [-Role] [-Name ] [-RemovePrivilege ] [-Server ] [-WhatIf] [-Co
nfirm] []


DESCRIPTION
Modifies the privileges of the provided roles.


PARAMETERS
-Role
Specify the roles you want to modify.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? true

-Name
Provide a new name for the provided role.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-AddPrivilege
Specify privileges and privilege groups you want to add to the provided roles.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true

-Server
Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the co
mmand runs on the default servers. For more information about default servers, see the description of Connect-V
IServer.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true

-WhatIf
Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modi
fied.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm
If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false,
the cmdlet runs without asking for user confirmation.

Required? false
Position? named
Default value $true
Accept pipeline input? false
Accept wildcard characters? false

-RemovePrivilege
Specify privileges or privilege groups you want to remove from the provided roles.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
Role


NOTES




-------------- Example 1 --------------

C:\PS>Set-VIRole -Role Role -AddPrivilege (Get-VIPrivilege -Name 'Create Datacenter')


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






RELATED LINKS
Online version: http://www.vmware.com/support/developer/PowerCLI/PowerCLI501/html/Set-VIRole.html
Get-VIRole
New-VIRole
Remove-VIRole
Get-VIPrivilege
Get-VIPermission
New-VIPermission
Remove-VIPermission
Set-VIPermission