Set-VIPermission
This cmdlet 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.
Syntax
-Permission
< Permission[] >
[-ProgressAction
< ActionPreference > ]
[-Propagate
< Boolean > ]
[-Role
< Role > ]
[-Server
< VIServer[] > ]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
Permission | Permission[] | named |
|
Specifies the permissions you want to modify. |
| optional | ProgressAction | ActionPreference | named |
|
|
| optional | Propagate | Boolean | named |
|
Indicates that you want to propagate the new permissions to the child inventory objects. |
| optional | Role | Role | named |
|
Specifies a new role for the permissions. |
| optional | Server | VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. |
Output
VMware.VimAutomation.ViCore.Types.V1.PermissionManagement.PermissionExamples
Example 1
Set-VIPermission -Permission $permission -Role Role -Propagate:$false
Changes the Propagate property of the $permission permission to $false.
Related Commands
VIPermission
This cmdlet retrieves the permissions defined on the specified inventory objects.
This cmdlet creates new permissions on the specified inventory objects for the provided users and groups in the role.
This cmdlet removes the specified permissions.
This cmdlet modifies the properties of the specified permissions.