Set-VIPermission Command | Vmware PowerCLI Reference

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

Set-VIPermission
-Permission < Permission[] >
[-ProgressAction < ActionPreference > ]
[-Propagate < Boolean > ]
[-Role < Role > ]
[-Server < VIServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Permission Permission[] named
  • pipeline
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
  • wildcards
Specifies a new role for the permissions.
optional Server VIServer[] named
  • wildcards
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.Permission

Examples

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.