Remove-SCSMUserRole

モジュール:
System.Center.Service.Manager Module

Service Manager からユーザー ロールを削除します。

構文

Default (既定) 

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

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-UserRole

ユーザーを削除する UserRole オブジェクトを指定します。

パラメーターのプロパティ

型:

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

ユーザー ロールを UserRole パラメーターにパイプできます。 たとえば、Get-SCSMUserRole コマンドレットによって返されるオブジェクトなどです。

出力

None.

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