Remove-SCSMUserRole
Service Manager からユーザー ロールを削除します。
構文
Remove-SCSMUserRole
[-UserRole] <Role[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-SCSMUserRole コマンドレットは、Service Managerからユーザー ロールを削除します。 ユーザー ロールの中には、システム ユーザー ロールとして指定されているために、削除できないものがあります。 次のコマンドを実行して、すべてのユーザー ロール オブジェクトの issystem 属性を表示できます。
Get-SCSMUserRole | Format-Table -Property DisplayName,{$_.userrole.issystem} -AutoSize
ユーザー ロールを削除できない場合、このコマンドレットは終了しないエラーを返します。
例
例 1: ユーザー ロールを削除する
PS C:\>Get-SCSMUserRole -Name "CustomUser" | Remove-SCSMUserRole
このコマンドは、Get-SCSMUserRole コマンドレットを使用して CustomUser という名前のユーザー ロールを取得します。 このコマンドは、パイプライン演算子を使用して、そのオブジェクトを現在のコマンドレットに渡します。 そのコマンドレットは、そのユーザー ロールを削除します。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
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
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
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 コマンドレットによって返されるオブジェクトを指定できます。
出力
None.
このコマンドレットは出力を生成しません。