Add-Computer

構文

Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-UnjoinDomainCredential <PSCredential>]
   -Credential <PSCredential>
   [-DomainName] <String>
   [-OUPath <String>]
   [-Server <String>]
   [-Unsecure]
   [-Options <JoinOptions>]
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-Credential <PSCredential>]
   [-WorkgroupName] <String>
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Add-Computer コマンドレットは、ローカル コンピューターまたはリモート コンピューターをドメインまたはワークグループに追加するか、ドメイン間で移動します。 また、アカウントなしでドメインに追加されたコンピューターのドメイン アカウントも作成します。

このコマンドレットのパラメーターを使用して、組織単位 (OU) およびドメイン コントローラーを指定したり、セキュリティで保護されていない参加を実行したりすることができます。

コマンドの結果を取得するには、 Verbose パラメーターと PassThru パラメーターを使用します。

例

例 1: ドメインにローカル コンピューターを追加し、コンピューターを再起動する

Add-Computer -DomainName Domain01 -Restart

このコマンドは、ローカル コンピューターを Domain01 ドメインに追加し、コンピューターを再起動して変更を有効にします。

例 2: ワークグループにローカル コンピューターを追加する

Add-Computer -WorkgroupName WORKGROUP-A

このコマンドは、ローカル コンピューターを Workgroup-A ワークグループに追加します。

例 3: ドメインにローカル コンピューターを追加する

Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose

このコマンドは、Domain01\DC01 ドメイン コントローラーを使用して、ローカル コンピューターを Domain01 ドメインに追加します。

コマンドは、 PassThru パラメーターと Verbose パラメーターを使用して、コマンドの結果に関する詳細情報を取得します。

例 4: OUPath パラメーターを使用してローカル コンピューターをドメインに追加する

Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"

このコマンドは、ローカル コンピューターを Domain02 ドメインに追加します。 OUPath パラメーターを使用して、新しいアカウントの組織単位を指定します。

例 5: 資格情報を使用してローカル コンピューターをドメインに追加する

Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -Force

このコマンドは、Server01 コンピューターを Domain02 ドメインに追加します。 LocalCredential パラメーターを使用して、Server01 コンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 Credential パラメーターを使用して、コンピューターをドメインに参加させるアクセス許可を持つユーザー アカウントを指定します。 Restart パラメーターを使用して、参加操作の完了後にコンピューターを再起動し、Force パラメーターを使用してユーザー確認メッセージを抑制します。

例 6: コンピューターのグループを新しいドメインに移動する

Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -Restart

このコマンドは、Server01、Server02、およびローカル コンピューターを Domain01 から Domain02 に移動します。

LocalCredential パラメーターを使用して、影響を受ける 3 台のコンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 UnjoinDomainCredential パラメーターを使用して、Domain01 ドメインからコンピューターの参加を解除するアクセス許可を持つユーザー アカウントと Credential パラメーターを指定して、コンピューターを Domain02 ドメインに参加させるアクセス許可を持つユーザー アカウントを指定します。 Restart パラメーターを使用して、移動が完了した後に 3 台のコンピューターをすべて再起動します。

例 7: コンピューターを新しいドメインに移動し、コンピューターの名前を変更する

Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -Restart

このコマンドは、Server01 コンピューターを Domain02 に移動し、コンピューター名を Server044 に変更します。

Server01 コンピューターへの接続には現在のユーザーの資格情報を使用し、このコンピューターを現在のドメインから削除します。 Credential パラメーターを使用して、コンピューターを Domain02 ドメインに参加させるアクセス許可を持つユーザー アカウントを指定します。

例 8: ファイルに一覧表示されているコンピューターを新しいドメインに追加する

Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade  -Restart

このコマンドは、 Servers.txt ファイルに一覧表示されているコンピューターを Domain02 ドメインに追加します。 Options パラメーターを使用して、Win9xUpgrade オプションを指定します。 Restart パラメーターは、結合操作の完了後に新しく追加されたすべてのコンピューターを再起動します。

例 9: 定義済みのコンピューター資格情報を使用してコンピューターをドメインに追加する

この最初のコマンドは、ドメイン Domain03に既に参加しているコンピューターから管理者が実行する必要があります。

New-ADComputer -Name "Server02" -AccountPassword (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)

# Then this command is run from `Server02` which is not yet domain-joined:

$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
    UserName = $null
    Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
Add-Computer -Domain "Domain03" -Options UnsecuredJoin,PasswordPass -Credential $joinCred

このコマンドの組み合わせにより、既存のドメインに参加しているコンピューターを使用して、ドメインに定義済みの名前と一時参加パスワードを持つ新しいコンピューター アカウントが作成されます。 その後、定義済みの名前を持つコンピューターは、コンピューター名と一時参加パスワードのみを使用してドメインに参加します。 定義済みのパスワードは、参加操作をサポートするためにのみ使用され、コンピューターが参加を完了した後、通常のコンピューター アカウントの手順の一部として置き換えられます。

パラメーター

-ComputerName

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

入力

String

コンピューター名と新しい名前を Add-Computer コマンドレットにパイプできます。

出力

ComputerChangeInfo

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

メモ

• Windows PowerShell 2.0 では、サーバーが存在する場合でも、Add-Computerの Server パラメーターは失敗します。 Windows PowerShell 3.0 では、 Server パラメーターの実装が変更され、確実に動作します。

関連リンク

• Checkpoint-Computer
• Remove-Computer
• Restart-Computer
• Rename-Computer
• Restore-Computer
• Stop-Computer
• Test-Connection