Remove-SCSMUserRole

  • リファレンス
モジュール:
System.Center.Service.Manager

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.

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