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 之前进行确认。

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

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

Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

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

输出

None.

此 cmdlet 将不生成任何输出。