![]() NAME New-VIRole SYNOPSIS Creates a new role on the specified servers and applies the provided privileges. SYNTAX New-VIRole [-Name] DESCRIPTION Creates a new role on the specified servers and applies the provided privileges. PARAMETERS -Name Specify a name for the new role. Required? true Position? 1 Default value Accept pipeline input? false Accept wildcard characters? false -Privilege Specify the privileges you want to apply to the new role. Required? false Position? 2 Default value Accept pipeline input? false Accept wildcard characters? true -Server Specify the vSphere server on which you want to run the cmdlet. If no value is given to this parameter, the com mand runs on the default servers. For more information about default servers, see the description of Connect-VI Server. 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 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>New-VIRole -Name Role -Privilege (Get-VIPrivilege -PrivilegeGroup) Creates a new role with the provided group privileges. RELATED LINKS Online version: http://www.vmware.com/support/developer/PowerCLI/PowerCLI501/html/New-VIRole.html Get-VIRole Remove-VIRole Set-VIRole Get-VIPrivilege Get-VIPermission New-VIPermission Remove-VIPermission Set-VIPermission |