Update-SCSMUserRole

構文

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

説明

Update-SCSMUserRole コマンドレットは、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変数に格納します。

2 番目のコマンドは、Get-SCSMUser コマンドレットを使用してユーザーを取得し、そのオブジェクトを$User変数に格納します。

3 番目のコマンドは、$Roleの User プロパティに$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

-PassThru

-UserRole

-WhatIf

入力

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

UserRole オブジェクトを UserRole パラメーターにパイプできます。 ユーザー ロールを取得するには、Get-SCSMUserRole コマンドレットを使用します。

出力

None.

このコマンドレットは出力を生成しません。

関連リンク

• Get-SCSMUser
• Get-SCSMUserRole
• New-SCSMUserRole
• Remove-SCSMUserRole