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 -Restart
UnjoinDoメイン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 -Restart
LocalCredential パラメーターは、リモート コンピューターに接続するアクセス許可を持つユーザーの資格情報を提供します。 UnjoinDoメインCredential パラメーターは、コンピューターを doメイン から削除するアクセス許可を持つユーザーの資格情報を提供します。 Force パラメーターは、各コンピューターの確認プロンプトを抑制します。 Restart パラメーターは、doメイン から削除された後、各コンピューターを再起動します。
例 3: 確認なしでワークグループからコンピューターを削除する
次の使用例は、リモート コンピューター、Server01、およびローカル コンピューターを doメイン から削除し、ローカル ワークグループに追加します。
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Force パラメーターは、各コンピューターの確認プロンプトを抑制します。 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\User01
PSCredential オブジェクトを入力します(例: .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