Share via

Remove-SCUserRolePermission

  • Reference
Module:
VirtualMachineManager

Removes a permission from a user role.

Syntax

Remove-SCUserRolePermission
      [-VMMServer <ServerConnection>]
      -UserRole <SelfServiceUserRole>
      -Cloud <Cloud>
      [-AllowLocalAdmin]
      [-Checkpoint]
      [-CheckpointRestoreOnly]
      [-DeployFromTemplateOnly]
      [-Deploy]
      [-PauseAndResume]
      [-RemoteConnect]
      [-Remove]
      [-Save]
      [-Shutdown]
      [-Start]
      [-Stop]
      [-Store]
      [-DeployShielded]
      [-MigrateVM]
      [-UpdateVMFunctionalLevel]
      [-ManageAzureProfiles]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCUserRolePermission
      [-VMMServer <ServerConnection>]
      -UserRole <SelfServiceUserRole>
      [-AllowLocalAdmin]
      [-Author]
      [-AuthorVMNetwork]
      [-CanShare]
      [-CanReceive]
      [-Checkpoint]
      [-CheckpointRestoreOnly]
      [-DeployFromTemplateOnly]
      [-Deploy]
      [-PauseAndResume]
      [-RemoteConnect]
      [-Remove]
      [-Save]
      [-Shutdown]
      [-Start]
      [-Stop]
      [-Store]
      [-DeployShielded]
      [-UpdateVMFunctionalLevel]
      [-ManageAzureProfiles]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCUserRolePermission
      [-VMMServer <ServerConnection>]
      -UserRole <SelfServiceUserRole>
      -HostGroup <HostGroup>
      [-AllowLocalAdmin]
      [-Checkpoint]
      [-CheckpointRestoreOnly]
      [-DeployFromTemplateOnly]
      [-Deploy]
      [-PauseAndResume]
      [-RemoteConnect]
      [-Remove]
      [-Save]
      [-Shutdown]
      [-Start]
      [-Stop]
      [-Store]
      [-DeployShielded]
      [-MigrateVM]
      [-UpdateVMFunctionalLevel]
      [-ManageAzureProfiles]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCUserRolePermission
      [-VMMServer <ServerConnection>]
      [-Cloud <Cloud>]
      -JobGroup <Guid>
      [-AllowLocalAdmin]
      [-Author]
      [-AuthorVMNetwork]
      [-CanShare]
      [-CanReceive]
      [-Checkpoint]
      [-CheckpointRestoreOnly]
      [-DeployFromTemplateOnly]
      [-Deploy]
      [-PauseAndResume]
      [-RemoteConnect]
      [-Remove]
      [-Save]
      [-Shutdown]
      [-Start]
      [-Stop]
      [-Store]
      [-DeployShielded]
      [-MigrateVM]
      [-UpdateVMFunctionalLevel]
      [-ManageAzureProfiles]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCUserRolePermission
      [-VMMServer <ServerConnection>]
      [-HostGroup <HostGroup>]
      -JobGroup <Guid>
      [-AllowLocalAdmin]
      [-Author]
      [-AuthorVMNetwork]
      [-CanShare]
      [-CanReceive]
      [-Checkpoint]
      [-CheckpointRestoreOnly]
      [-DeployFromTemplateOnly]
      [-Deploy]
      [-PauseAndResume]
      [-RemoteConnect]
      [-Remove]
      [-Save]
      [-Shutdown]
      [-Start]
      [-Stop]
      [-Store]
      [-DeployShielded]
      [-MigrateVM]
      [-UpdateVMFunctionalLevel]
      [-ManageAzureProfiles]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCUserRolePermission
      [-VMMServer <ServerConnection>]
      -UserRolePermission <UserRolePermission>
      [-AllowLocalAdmin]
      [-Checkpoint]
      [-CheckpointRestoreOnly]
      [-DeployFromTemplateOnly]
      [-Deploy]
      [-PauseAndResume]
      [-RemoteConnect]
      [-Remove]
      [-Save]
      [-Shutdown]
      [-Start]
      [-Stop]
      [-Store]
      [-DeployShielded]
      [-MigrateVM]
      [-UpdateVMFunctionalLevel]
      [-ManageAzureProfiles]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

The Remove-SCUserRolePermission cmdlet removes a permission from a user role.

Note

  • The parameter HostGroup can be used only when the UserRole parameter is VMAdmin.

Parameters

-AllowLocalAdmin

Indicates that this cmdlet removes the Allow Local Admin permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Author

Indicates that this cmdlet removes the Author permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthorVMNetwork

Indicates that this cmdlet removes the Author VMNetwork permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CanReceive

Indicates that this cmdlet removes the Can Receive permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CanShare

Indicates that this cmdlet removes the Can Share permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Checkpoint

Indicates that this cmdlet removes the Can Checkpoint permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckpointRestoreOnly

Indicates that this cmdlet removes the Can Checkpoint Restore Only permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Cloud

Specifies a private cloud object for which this cmdlet modifies a user role.

Type:Cloud
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Deploy

Indicates that this cmdlet removes the Deploy virtual machine permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployFromTemplateOnly

Indicates that this cmdlet removes the Deploy From Template Only virtual machine permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployShielded

Indicates that this cmdlet removes the Deploy Shielded permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostGroup

Specifies a host group object for which this cmdlet gets user role permission objects.

Type:HostGroup
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

Specifies an identifier for a series of commands that runs as a set just before the final command that includes the same job group identifier runs.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Specifies a variable in which job progress is tracked and stored.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManageAzureProfiles

Indicates that this cmdlet removes the Manage Azure profiles permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MigrateVM

Indicates that this cmdlet removes the Migrate Virtual Machine permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Specifies a user name. This cmdlet operates on behalf of the user that this parameter specifies.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Specifies a user role. To obtain a user role, use the Get-SCUserRole cmdlet. This cmdlet operates on behalf of the user role that this parameter specifies.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PauseAndResume

Indicates that this cmdlet removes the Can Pause And Resume permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoteConnect

Indicates that this cmdlet removes the Remote Connect permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Remove

Indicates that this cmdlet removes the Can Remove permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Save

Indicates that this cmdlet removes the Can Save VM permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Shutdown

Indicates that this cmdlet removes the Can Shutdown virtual machine permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Start

Indicates that this cmdlet removes the Can Start virtual machine permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Stop

Indicates that this cmdlet removes the Can Stop virtual machine permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Store

Indicates that this cmdlet removes the Can Store virtual machine permission.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpdateVMFunctionalLevel

Indicates that this cmdlet removes the permission to update virtual machine functional level.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

Specifies a user role from which this cmdlet removes permissions.

Type:SelfServiceUserRole
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-UserRolePermission

Specifies a UserRolePermission from which this cmdlet removes permissions. To obtain a user role permission, use the Get-SCUserRolePermission cmdlet.

Type:UserRolePermission
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Specifies a Virtual Machine Manager (VMM) server on which this cmdlet removes permissions.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False