Remove-CMUser

Configuration Managerからユーザーを削除します。

構文

Remove-CMUser
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUser
      [-Force]
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUser
      [-Force]
      [-ResourceId] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-CMUser コマンドレットは、ユーザー アカウントをConfiguration Managerから削除します。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例 1: ユーザーを削除する

PS XYZ:\> $User = Get-CMUser -CollectionName "All Users" -Name "Contoso\user01"
PS XYZ:\> Remove-CMUser -InputObject $User -Force

最初のコマンドは、user01 という名前のユーザー オブジェクトを All Users コレクションから取得し、そのオブジェクトを $User 変数に格納します。

2 番目のコマンドは、$Userに格納されているユーザー アカウントを削除します。 Force パラメーターを指定すると、ユーザー アカウントが削除される前にユーザーにプロンプトが表示されないことを示します。

例 2: パイプラインを使用してユーザーを削除する

PS XYZ:\> Get-CMUser -CollectionName "All Users" -Name "Contoso\user02" | Remove-CMUser -Force

このコマンドは、user02 という名前のユーザー オブジェクトを All Users コレクションから取得し、パイプライン演算子を使用して オブジェクトを Remove-CMUser に渡します。これにより、ユーザー アカウントが削除されます。 Force パラメーターを指定すると、ユーザー アカウントが削除される前にユーザーにプロンプトが表示されないことを示します。

パラメーター

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Configuration Manager ユーザー アカウント オブジェクトを指定します。 Configuration Manager ユーザー アカウント オブジェクトを取得するには、Get-CMUser コマンドレットを使用します。

Type:IResultObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

ユーザー アカウントの名前を指定します。

Type:String
Aliases:UserName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-ResourceId

ユーザー アカウントのリソース ID を指定します。

Type:Int32
Aliases:Id, UserId
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object