共用方式為

Update-SCSMUserRole

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

設定 Service Manager 使用者的 UserRole 屬性。

語法

Update-SCSMUserRole
      [-UserRole] <Role[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-SCSMUserRole Cmdlet 會設定 Service Manager 使用者的 UserRole 属性。

範例

範例 1：將使用者新增至使用者角色

PS C:\>$Role = Get-SCSMUserRole -Name "IncidentResolvers"
PS C:\> $User = Get-SCSMUser -UserName "PattiFuller"
PS C:\> $Role.User += $User
PS C:\> Update-SCSMUserRole -Role $Role

第一個命令會使用 get-SCSMUserRole取得名為 IncidentResolvers 的使用者角色，然後將它儲存在$Role變數中。

第二個命令會使用 Get-SCSMUser Cmdlet 來取得使用者，然後將該物件儲存在$User變數中。

第三個命令會將$User附加至 $Role User 屬性。

最後一個命令會更新角色，以符合目前$Role的值。

範例 2：從角色移除使用者

PS C:\>Get-SCSMUserRole -Name "Administrators"
WOODGROVE\Administrator
WOODGROVE\Domain Admins


The second command assigns the user role previously displayed to the $Role variable. 
PS C:\>$Role = Get-SCSMUserRole -Name "Administrators"

The third command assigns the first user role to the **User** property of $Role. This command that property, removing all except the specified user. 
PS C:\>$Role.User = $Role.Users[0]

The final command updates the role to match the current value of $Role.
PS C:\>Update-SCSMUserRole -Role $Role

此範例會從使用者角色中移除使用者。 第一個命令會顯示系統管理員。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:System.Management.Automation.SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

指出此 Cmdlet 會傳回其更新的使用者角色。 您可以將這個物件傳遞至其他 Cmdlet。

類型:System.Management.Automation.SwitchParameter
Position:Named
預設值:None
必要: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 物件傳送至 UserRole 參數。 若要取得使用者角色，請使用 Get-SCSMUserRole Cmdlet。

輸出

None.

此 Cmdlet 不會產生任何輸出。