次の方法で共有

Remove-Computer

  • リファレンス
モジュール:
Microsoft.PowerShell.Management

ドメインからローカル コンピューターを削除します。

構文

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 コマンドレットは、ローカル コンピューターとリモート コンピューターを現在のドメインから削除します。

ドメインからコンピューターを削除すると、Remove-Computer はコンピューターのドメイン アカウントも無効にします。 コンピューターが現在のユーザーの資格情報である場合でも、そのドメインから参加を解除するには、明示的な資格情報を指定する必要があります。 変更を有効にするには、コンピューターを再起動する必要があります。 また、ドメインからコンピューターを削除する場合は、ワークグループに移動する必要があります。 ワークグループを指定するには、WorkgroupName パラメーターを使用します。

コンピューターをワークグループからドメイン、ワークグループ間、またはドメイン間で移動するには、Add-Computer コマンドレットを使用します。

コマンドの結果を取得するには、詳細 を使用し、PassThru パラメーター します。 ユーザー プロンプトを非表示にするには、Force パラメーターを使用します。

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 の ComputerName パラメーターを使用できます。

このパラメーターは PowerShell 3.0 で導入されました。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

ユーザー プロンプトを表示しない。 既定では、Remove-Computer は各コンピューターを削除する前に確認を求められます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LocalCredential

ComputerName パラメーターが指定するコンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。

User01 や Domain01\User01などのユーザー名を入力するか、PSCredential オブジェクト (Get-Credential コマンドレットによって生成されたものなど) を入力します。 ユーザー名を入力すると、コマンドレットによってパスワードの入力が求められます。 コンピューターを現在のドメインから削除するアクセス許可を持つユーザー アカウントを指定するには、UnjoinDomainCredential パラメーターを使用します。

このパラメーターは PowerShell 3.0 で導入されました。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

コマンドの結果を返します。 それ以外の場合、このコマンドレットは出力を生成しません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Restart

このコマンドレットは、削除されるコンピューターを再起動することを示します。 多くの場合、変更を有効にするには再起動が必要です。

このパラメーターは PowerShell 3.0 で導入されました。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UnjoinDomainCredential

コンピューターを現在のドメインから削除するアクセス許可を持つユーザー アカウントを指定します。 このパラメーターで指定されている明示的な資格情報は、値が現在のユーザーの資格情報である場合でも、ドメインからリモート コンピューターを削除するために必要です。

User01 や Domain01\User01などのユーザー名を入力するか、PSCredential オブジェクト (Get-Credentialによって生成されたものなど) を入力します。 ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。

リモート コンピューターに接続するアクセス許可を持つユーザー アカウントを指定するには、LocalCredential パラメーターを使用します。

このパラメーターは PowerShell 3.0 で導入されました。

型:PSCredential
Aliases:Credential
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WorkgroupName

コンピューターがドメインから削除されるときに追加されるワークグループの名前を指定します。 既定値はワークグループ です。 ドメインからコンピューターを削除する場合は、ワークグループに追加する必要があります。

このパラメーターは PowerShell 3.0 で導入されました。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

コンピューター名をこのコマンドレットにパイプできます。

出力

ComputerChangeInfo

PassThru パラメーターを使用すると、Remove-Computer は ComputerChangeInfo オブジェクトを返します。 それ以外の場合、このコマンドレットは出力を生成しません。

メモ

このコマンドレットは、ワークグループからコンピューターを削除しません。