次の方法で共有

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 コマンドレットを使用します。

コマンドの結果を取得するには、Verbose パラメーターと 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-ComputerComputerName パラメーターを使用できます。

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

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

このパラメーターは 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

入力

String

コンピューター名を thiscmdlet にパイプできます。

出力

ComputerChangeInfo

PassThru パラメーターを使用すると、 Remove-ComputerComputerChangeInfo オブジェクトが返されます。 それ以外の場合、このコマンドレットによる出力はありません。

メモ

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