ローカル コンピューターをワークグループまたはドメインから削除します。
構文
Remove-Computer [[-Credential] <PSCredential>] [-Force] [-PassThru] [-確認] [-WhatIf] [<CommonParameters>]
説明
Remove-Computer コマンドレットは、現在のワークグループまたはドメインからローカル コンピューターを削除します。
コンピューターをドメインから削除すると、Remove-Computer によって、コンピューターのドメイン アカウントも無効になります。
コンピューターがドメインにある場合は、現在のユーザーであっても資格情報を提供し、変更を有効にするためにコンピューターを再起動する必要があります。
コマンドの結果を取得するには、Verbose パラメーターと PassThru パラメーターを使用します。
パラメーター
-Credential <PSCredential>
この処理を実行するアクセス許可を持つユーザー アカウントを指定します。既定値は現在のユーザーです。
"User01" や "Domain01\User01" のようなユーザー名を入力するか、Get-Credential コマンドレットで生成されるような PSCredential オブジェクトを入力します。ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。
コンピューターをドメインから削除するには、現在のユーザーの資格情報を使用している場合でも Credential パラメーターを使用する必要があります。
|
必須 |
false |
|
位置 |
2 |
|
既定値 |
The credentials of the current user |
|
パイプライン入力を許可する |
false |
|
ワイルドカード文字を許可する |
false |
-Force
|
必須 |
false |
|
位置 |
named |
|
既定値 |
|
|
パイプライン入力を許可する |
false |
|
ワイルドカード文字を許可する |
false |
-PassThru
コマンドの結果を返します。それ以外の場合、このコマンドレットによる出力はありません。
|
必須 |
false |
|
位置 |
named |
|
既定値 |
|
|
パイプライン入力を許可する |
false |
|
ワイルドカード文字を許可する |
false |
-確認
コマンドを実行する前に確認メッセージを表示します。
|
必須 |
false |
|
位置 |
named |
|
既定値 |
|
|
パイプライン入力を許可する |
false |
|
ワイルドカード文字を許可する |
false |
-WhatIf
実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。
|
必須 |
false |
|
位置 |
named |
|
既定値 |
|
|
パイプライン入力を許可する |
false |
|
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。Ô”¼š¤Ë¤Ä¤¤¤Æ¤Ï¡¢次を参照してください: about_Commonparameters.
入力と出力
入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。
|
入力 |
なし パイプを使用してこのコマンドレットに入力を渡すことはできません。 |
|
出力 |
Microsoft.PowerShell.Commands.ComputerChangeInfo PassThru パラメーターを使用すると、Remove-Computer は ComputerChangeInfo オブジェクトを返します。それ以外の場合、このコマンドレットによる出力はありません。 |
例 1
C:\PS>remove-computer 説明 ----------- このコマンドは、ワークグループからコンピューターを削除します。
例 2
C:\PS>remove-computer -credential domain01\admin01 -passthru -verbose; restart-computer 説明 ----------- このコマンドは、ローカル コンピューターをその参加先のドメインから削除します。 まず、このコマンドは、ドメインからコンピューターを削除します。このコマンドは、Credential パラメーターを使用して、ドメイン管理者の資格情報を提供します。PassThru パラメーターと Verbose 共通パラメーターを使用してコマンドの成功または失敗に関する情報を表示します。 2 番目のコマンドは、削除操作の完了に必要な Restart-Computer コマンドレットを使用してコンピューターを再起動します。 2 つのコマンドは、セミコロン (;) で区切ります。
関連項目