Remove-Computer
ドメインからローカル コンピューターを削除します。
構文
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-Computer
-UnjoinDomainCredential <PSCredential>
[-LocalCredential <PSCredential>]
[-Restart]
[-ComputerName <String[]>]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
このコマンドレットはRemove-Computer、ローカル コンピューターとリモート コンピューターを現在の doメイン から削除します。
doメイン からコンピューターを削除すると、Remove-Computerコンピューターの doメイン アカウントも無効になります。 コンピューターが現在のユーザーの資格情報である場合でもメインコンピューターの参加を解除するには、明示的な資格情報を指定する必要があります。 変更を有効にするには、コンピューターを再起動する必要があります。 ドメインからコンピューターを削除する際に、コンピューターをワークグループに移動する必要もあります。 ワークグループを指定するには、 WorkgroupName パラメーターを使用します。
コンピューターをワークグループから doメイン に移動したり、ワークグループ間で移動したり、あるワークグループから別のワークグループに移動したり、メインから別のワークグループに移動したりするには、コマンドレットをAdd-Computer使用します。
コマンドの結果を取得するには、Verbose パラメーターと PassThru パラメーターを使用します。 ユーザー プロンプトを表示しない場合は、Force パラメーターを使用します。
Remove-Computerは、ローカル コンピューターとリモート コンピューターを doメイン から削除します。 これには、リモート コンピューターに接続するための代替資格情報を指定する資格情報パラメーター、doメイン からの参加解除、影響を受けるコンピューターを再起動するための Restart パラメーター、コンピューターの追加先となるワークグループの名前を指定するための WorkgroupName パラメーターが含まれます。
例
例 1: ローカル コンピューターを削除しますメイン
次の使用例は、参加している doメイン からローカル コンピューターを削除します。
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -RestartUnjoinDoメインCredential パラメーターは、doメイン 管理者の資格情報を提供します。 PassThru および Verbose 共通パラメーターには、コマンドの成功または失敗に関する情報が表示されます。 Restart パラメーターは、コンピューターを再起動して削除操作を完了します。
ワークグループ名が指定されていない場合、コンピューターは do から削除された後に名前が付けられたワークグループに移動メイン。
例 2: 複数のコンピューターをレガシ ワークグループに移動する
次の使用例は、ファイルにOldServers.txt一覧表示されているすべてのコンピューターを doメイン から削除し、レガシ ワークグループに移動します。
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -RestartLocalCredential パラメーターは、リモート コンピューターに接続するアクセス許可を持つユーザーの資格情報を提供します。 UnjoinDoメインCredential パラメーターは、コンピューターを doメイン から削除するアクセス許可を持つユーザーの資格情報を提供します。 Force パラメーターは、各コンピューターの確認プロンプトを抑制します。 Restart パラメーターは、doメイン から削除された後、各コンピューターを再起動します。
例 3: 確認なしでワークグループからコンピューターを削除する
次の使用例は、リモート コンピューター、Server01、およびローカル コンピューターを doメイン から削除し、ローカル ワークグループに追加します。
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -ForceForce パラメーターは、各コンピューターの確認プロンプトを抑制します。 Restart パラメーターは、変更を有効にするためにコンピューターを再起動します。
パラメーター
-ComputerName
ドメインから削除するコンピューターを指定します。 既定値はローカル コンピューターです。
リモート コンピューターの NetBIOS 名、IP アドレス、または完全修飾 doメイン 名 (FQDN) を入力します。 ローカル コンピューターを指定するには、コンピューター名、ドット (.)、または localhost.
このパラメーターは、PowerShell リモート処理には依存しません。 コンピューターがリモート コマンドを 実行するように構成されていない場合でも、ComputerName パラメーター Remove-Computer を使用できます。
このパラメーターは PowerShell 3.0 で導入されました。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
ユーザー プロンプトが表示されないようにします。 既定では、 Remove-Computer 各コンピューターを削除する前に確認を求められます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LocalCredential
ComputerName パラメーターが指定するコンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
ユーザー名を入力するか、User01またはDomain01\User01、コマンドレットによってGet-Credential生成された PSCredential オブジェクトを入力します。 ユーザー名を入力すると、コマンドレットによってパスワードの入力が求められます。 コンピューターを現在の do から削除するアクセス許可を持つユーザー アカウントを指定するにはメインUnjoinDoメインCredential パラメーターを使用します。
このパラメーターは PowerShell 3.0 で導入されました。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
コマンドの結果を返します。 それ以外の場合、このコマンドレットによる出力はありません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Restart
このコマンドレットは、削除されるコンピューターを再起動することを示します。 多くの場合、変更を有効にするには再起動が必要です。
このパラメーターは PowerShell 3.0 で導入されました。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnjoinDomainCredential
コンピューターを現在のドメインから削除するアクセス許可を持つユーザー アカウントを指定します。 ドメインからリモート コンピューターを削除するには、このパラメーターに資格情報を、それが現在のユーザーの資格情報であっても明示的に指定する必要があります。
ユーザー名を入力するか、User01または Domain01\User01PSCredential オブジェクトを入力します(例: .Get-Credential ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。
リモート コンピューターに接続するアクセス許可を持つユーザー アカウントを指定するには、LocalCredential パラメーターを使用します。
このパラメーターは PowerShell 3.0 で導入されました。
| Type: | PSCredential |
| Aliases: | Credential |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| 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 |
-WorkgroupName
ドメインから削除したコンピューターの追加先ワークグループの名前を指定します。 既定値は WORKGROUP です。 ドメインからコンピューターを削除する際に、コンピューターをワークグループに追加する必要があります。
このパラメーターは PowerShell 3.0 で導入されました。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
コンピューター名をこのコマンドレットにパイプできます。
出力
PassThru パラメーターを使用する場合は、 Remove-Computer ComputerChangeInfo オブジェクトを返します。
それ以外の場合、このコマンドレットによる出力はありません。
メモ
このコマンドレットは、コンピューターをワークグループから削除しません。
関連リンク
PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示