Remove-SCSMUserRole
从 Service Manager 中删除用户角色。
语法
Remove-SCSMUserRole
[-UserRole] <Role[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Remove-SCSMUserRole cmdlet 从 Service Manager 中删除用户角色。
某些用户角色被指定为系统用户角色,无法删除。
可以运行以下命令以显示所有用户角色对象的 属性
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 不生成任何输出。