Remove-Computer
ドメインからローカル コンピューターを削除します。
構文
Local (既定)
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remote
Remove-Computer
-UnjoinDomainCredential <PSCredential>
[-LocalCredential <PSCredential>]
[-Restart]
[-ComputerName <String[]>]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-Computer コマンドレットは、ローカル コンピューターとリモート コンピューターを現在のドメインから削除します。
ドメインからコンピューターを削除すると、Remove-Computer はコンピューターのドメイン アカウントも無効にします。 コンピューターが現在のユーザーの資格情報である場合でも、そのドメインから参加を解除するには、明示的な資格情報を指定する必要があります。 変更を有効にするには、コンピューターを再起動する必要があります。 また、ドメインからコンピューターを削除する場合は、ワークグループに移動する必要があります。 ワークグループを指定するには、WorkgroupName パラメーターを使用します。
コンピューターをワークグループからドメイン、ワークグループ間、またはドメイン間で移動するには、Add-Computer コマンドレットを使用します。
コマンドの結果を取得するには、
Remove-Computer は、ローカル コンピューターとリモート コンピューターをドメインから削除します。 これには、リモート コンピューターに接続するための代替資格情報を指定する資格情報パラメーター、ドメインからの参加解除、影響を受けるコンピューターを再起動するための Restart パラメーター、およびコンピューターを追加するワークグループの名前を指定するための WorkgroupName パラメーターが含まれます。
例
例 1: ローカル コンピューターをドメインから削除する
次の使用例は、参加しているドメインからローカル コンピューターを削除します。
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
UnjoinDomainCredential パラメーターは、ドメイン管理者の資格情報を提供します。 PassThru と Verbose 共通パラメーターには、コマンドの成功または失敗に関する情報が表示されます。 Restart パラメーターは、コンピューターを再起動して削除操作を完了します。
ワークグループ名が指定されていない場合、コンピューターはドメインから削除された名前のワークグループに移動されます。
例 2: 複数のコンピューターをレガシ ワークグループに移動する
次の使用例は、OldServers.txt ファイルに表示されているすべてのコンピューターをドメインから削除し、レガシ ワークグループに移動します。
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart
LocalCredential パラメーターは、リモート コンピューターに接続するアクセス許可を持つユーザーの資格情報を提供します。 UnjoinDomainCredential パラメーターは、ドメインからコンピューターを削除する権限を持つユーザーの資格情報を提供します。 Force パラメーターは、各コンピューターの確認プロンプトを抑制します。 Restart パラメーターは、ドメインから削除された後、各コンピューターを再起動します。
例 3: 確認なしでワークグループからコンピューターを削除する
次の使用例は、リモート コンピューター、Server01、およびローカル コンピューターをドメインから削除し、ローカル ワークグループに追加します。
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Force パラメーターは、各コンピューターの確認プロンプトを表示しないようにします。 Restart パラメーターは、変更を有効にするためにコンピューターを再起動します。
パラメーター
-ComputerName
ドメインから削除するコンピューターを指定します。 既定値はローカル コンピューターです。
リモート コンピューターの NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を入力します。 ローカル コンピューターを指定するには、コンピューター名、ドット (.)、または localhostを入力します。
このパラメーターは、PowerShell リモート処理には依存しません。 コンピューターがリモート コマンドを実行するように構成されていない場合でも、 の Remove-Computer パラメーターを使用できます。
このパラメーターは PowerShell 3.0 で導入されました。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Remote
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
ユーザー プロンプトを表示しない。 既定では、Remove-Computer は各コンピューターを削除する前に確認を求められます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LocalCredential
ComputerName パラメーターが指定するコンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
User01 や Domain01\User01などのユーザー名を入力するか、PSCredential オブジェクト (Get-Credential コマンドレットによって生成されたものなど) を入力します。 ユーザー名を入力すると、コマンドレットによってパスワードの入力が求められます。 コンピューターを現在のドメインから削除するアクセス許可を持つユーザー アカウントを指定するには、UnjoinDomainCredential パラメーターを使用します。
このパラメーターは PowerShell 3.0 で導入されました。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Remote
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PassThru
コマンドの結果を返します。 それ以外の場合、このコマンドレットは出力を生成しません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Restart
このコマンドレットは、削除されるコンピューターを再起動することを示します。 多くの場合、変更を有効にするには再起動が必要です。
このパラメーターは PowerShell 3.0 で導入されました。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UnjoinDomainCredential
コンピューターを現在のドメインから削除するアクセス許可を持つユーザー アカウントを指定します。 このパラメーターで指定されている明示的な資格情報は、値が現在のユーザーの資格情報である場合でも、ドメインからリモート コンピューターを削除するために必要です。
User01 や Domain01\User01などのユーザー名を入力するか、PSCredential オブジェクト (Get-Credentialによって生成されたものなど) を入力します。 ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。
リモート コンピューターに接続するアクセス許可を持つユーザー アカウントを指定するには、LocalCredential パラメーターを使用します。
このパラメーターは PowerShell 3.0 で導入されました。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 資格 |
パラメーター セット
Local
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Remote
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WorkgroupName
コンピューターがドメインから削除されるときに追加されるワークグループの名前を指定します。 既定値はワークグループ です。 ドメインからコンピューターを削除する場合は、ワークグループに追加する必要があります。
このパラメーターは PowerShell 3.0 で導入されました。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
String
コンピューター名をこのコマンドレットにパイプできます。
出力
ComputerChangeInfo
PassThru パラメーターを使用すると、Remove-Computer は ComputerChangeInfo オブジェクトを返します。
それ以外の場合、このコマンドレットは出力を生成しません。
メモ
このコマンドレットは、ワークグループからコンピューターを削除しません。
