共用方式為

Remove-SCSMUserRole

  • 參考
模組:
System.Center.Service.Manager

從 Service Manager 移除使用者角色。

語法

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

Description

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 不會產生任何輸出。