Update-SCSMUserRole
Service Manager ユーザーの UserRole プロパティを設定します。
構文
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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
このコマンドレットによって、更新されたユーザー ロールが返されることを示します。 このオブジェクトは、他のコマンドレットに渡すことができます。
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
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
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
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 オブジェクトを UserRole パラメーターにパイプできます。 ユーザー ロールを取得するには、Get-SCSMUserRole コマンドレットを使用します。
出力
None.
このコマンドレットは出力を生成しません。