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 将不生成任何输出。