vSphere PowerCLI Cmdlets Reference

Set-VIPermission

Synopsis

Modifies the properties of the specified permissions.

Syntax

Set-VIPermission [-Permission] <Permission[]> [-Role <Role>] [-Propagate [<Boolean>]] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-VIPermission
New-VIPermission
Remove-VIPermission
Get-VIPrivilege
Get-VIRole
New-VIRole
Remove-VIRole
Set-VIRole

Detailed Description

Modifies the properties of the specified permissions. The cmdlet can change the role and define whether the permission propagates down the hierarchy to child inventory objects.

Parameters

NameDescriptionRequired?Pipeline InputDefault Value
PermissionSpecify the permissions you want to modify.truetrue (ByValue)
RoleSpecify a new role for the permissions.falsefalse
PropagateIndicate that you want to propagate the new permissions to the child inventory objects.falsefalse$true
WhatIfIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse
ConfirmIf 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.falsefalse$true

Return Type

Permission

Notes

Examples

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

Set-VIPermission -Permission $permission -Role Role -Propagate:$false

Changes the Propagate property of the $permission permission to $false.


Copyright © 1998 - 2010 VMware, Inc. All rights reserved.