Remove-SCUserRole

删除现有用户角色。

语法

Remove-SCUserRole
      [-UserRole] <UserRole>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

说明

Remove-SCUserRole cmdlet 从 Virtual Machine Manager(VMM)中删除现有用户角色。 可以删除以下角色:委派的管理员、Read-Only 管理员或 Self-Service 用户。 无法删除管理员角色。

示例

示例 1:删除指定的用户角色

PS C:\> $UserRole = Get-SCUserRole -Name "ContosoDelegatedAdmin"
PS C:\> Remove-SCUserRole -UserRole $UserRole

第一个命令获取名为 ContosoDelegatedAdmin 的用户角色对象,然后将该对象存储在$UserRole变量中。

第二个命令从 VMM 数据库中删除存储在 $UserRole 中的用户角色。

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-JobGroup

指定一系列命令的标识符,这些命令在包含同一作业组标识符运行的最后一个命令之前作为集运行。

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-JobVariable

指定在其中跟踪和存储作业进度的变量。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-OnBehalfOfUser

指定用户名。 此 cmdlet 代表此参数指定的用户运行。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-OnBehalfOfUserRole

指定用户角色。 若要获取用户角色,请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。

类型:UserRole
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PROTipID

指定触发此操作的性能和资源优化提示(PRO 提示)的 ID。 此参数允许你审核 PRO 提示。

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunAsynchronously

指示作业以异步方式运行,以便控件立即返回到命令行界面。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UserRole

指定此 cmdlet 删除的用户角色对象。 若要获取用户角色,请使用 Get-SCUserRole cmdlet。

类型:UserRole
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False