Remove-SCSMUserRole

从 Service Manager 中删除用户角色。

语法

Remove-SCSMUserRole
      [-UserRole] <Role[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-SCSMUserRole cmdlet 从 Service Manager 中删除用户角色。 某些用户角色被指定为系统用户角色,无法删除。 可以运行以下命令以显示所有用户角色对象的 属性 issystem

Get-SCSMUserRole | Format-Table -Property DisplayName,{$_.userrole.issystem} -AutoSize

如果无法删除用户角色,此 cmdlet 将返回非终止错误。

示例

示例 1:删除用户角色

PS C:\>Get-SCSMUserRole -Name "CustomUser" | Remove-SCSMUserRole

此命令使用 Get-SCSMUserRole cmdlet 获取名为 CustomUser 的用户角色。 该命令使用管道运算符将该对象传递给当前 cmdlet。 该 cmdlet 删除该用户角色。

参数

-Confirm

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

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

-UserRole

指定要从中删除用户的 UserRole 对象。

类型:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

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

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

输入

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

可以通过管道将用户角色传递给 UserRole 参数。 例如,Get-SCSMUserRole cmdlet 返回的对象。

输出

None.

此 cmdlet 不生成任何输出。