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 パラメーターは、参加操作の完了後に、新たに追加されたすべてのコンピューターを再起動します。
パラメーター
-ComputerName
ドメインまたはワークグループに追加するコンピューターを指定します。 既定値はローカル コンピューターです。
NetBIOS 名、インターネット プロトコル (IP) アドレス、または各リモート コンピューターの完全修飾ドメイン名を入力します。 ローカル コンピューターを指定するには、コンピューター名、ドット (.)、または「localhost」を入力します。
このパラメーターは、Windows PowerShell リモート処理に依存しません。
コンピューターがリモート コマンドを実行するように構成されていない場合でも、 の Add-Computer
ComputerName パラメーターを使用できます。
このパラメーターは、Windows PowerShell 3.0 で導入されました。
Type: | String[] |
Position: | Named |
Default value: | Local computer |
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 |
-Credential
新しいドメインにコンピューターを追加するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
「User01」や「Domain01\User01」のようなユーザー名を入力するか、 コマンドレットで生成されるような Get-Credential
オブジェクトを入力します。
ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。
コンピューターを現在のドメインから削除するアクセス許可を持つユーザー アカウントを指定するには、UnjoinDomainCredential パラメーターを使用します。 リモート コンピューターに接続するアクセス許可を持つユーザー アカウントを指定するには、LocalCredential パラメーターを使用します。
Type: | PSCredential |
Aliases: | DomainCredential |
Position: | Named |
Default value: | Current User Account Credentials |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
コンピューターが追加されるドメインを指定します。 このパラメーターは、コンピューターをドメインに追加する場合に必要です。
Type: | String |
Aliases: | DN, Domain |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
ユーザーへの確認メッセージを表示しないようにします。
このパラメーターを指定しない場合は、 Add-Computer
各コンピューターの追加を確認する必要があります。
このパラメーターは、Windows PowerShell 3.0 で導入されました。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalCredential
ComputerName パラメーターで指定されたコンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
「User01」や「Domain01\User01」のようなユーザー名を入力するか、 コマンドレットで生成されるような Get-Credential
オブジェクトを入力します。
ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。
新しいドメインにコンピューターを追加するアクセス許可を持つユーザー アカウントを指定するには、Credential パラメーターを使用します。 コンピューターを現在のドメインから削除するアクセス許可を持つユーザー アカウントを指定するには、UnjoinDomainCredential パラメーターを使用します。
このパラメーターは、Windows PowerShell 3.0 で導入されました。
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
新しいドメインでのコンピューターの新しい名前を指定します。 このパラメーターは、1 つのコンピューターが追加または移動されている場合にのみ有効です。
このパラメーターは、Windows PowerShell 3.0 で導入されました。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Options
コンピューターの追加参加操作の詳細オプションを指定します。 1 つ以上の値をコンマ区切りの文字列として入力します。
このパラメーターの有効値は、次のとおりです。
AccountCreate: ドメイン アカウントを作成します。 Add-Computer コマンドレットは、コンピューターをドメインに追加するときに、ドメイン アカウントを自動的に作成します。 このオプションは、完全のために含まれています。
Win9XUpgrade: 参加操作が Windows オペレーティング システムのアップグレードの一部であることを示します。
UnsecuredJoin: セキュリティで保護されていない結合を実行します。 セキュリティで保護されていない結合を要求するには、 Unsecure パラメーターまたはこのオプションを使用します。
PasswordPass: セキュリティで保護されていない結合を実行した後、コンピューターのパスワードを Credential(DomainCredential) パラメーターの値に設定します。 このオプションは、Credential (DomainCredential) パラメーターの値がコンピューターのパスワードであってユーザーのパスワードではないことも示します。 このオプションは、UnsecuredJoin オプションを指定する場合にのみ有効です。
-- JoinWithNewName: 新しいドメインのコンピューター名を NewName パラメーターで指定された名前に変更します。 NewName パラメーターを使用すると、このオプションは自動的に設定されます。 このオプションは、Rename-Computer コマンドレットで使用するように設計されています。 Rename-Computer コマンドレットを使用してコンピューターの名前を変更しても、コンピューターを再起動して変更を有効にしない場合は、このパラメーターを使用して、コンピューターを新しい名前のドメインに参加させることができます。
JoinReadOnly: 既存のコンピューター アカウントを使用して、コンピューターを読み取り専用ドメイン コントローラーに参加させます。 パスワード レプリケーション ポリシーの許可リストにマシン アカウントを追加し、参加操作の前にアカウント パスワードを読み取り専用ドメイン コントローラーにレプリケートする必要があります。
InstallInvoke: JoinDomainOrWorkgroup メソッドの FJoinOptions パラメーターの作成 (0x2) フラグと削除フラグ (0x4) を設定します。 JoinDomainOrWorkgroup メソッドの詳細については、MSDN ライブラリの Win32_ComputerSystem クラスの JoinDomainOrWorkgroup メソッドに関するページを参照してください。 これらのオプションの詳細については、MSDN ライブラリの NetJoinDomain 関数 を参照してください。
このパラメーターは Windows PowerShell 3.0 で導入されました。
Type: | JoinOptions |
Accepted values: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OUPath
ドメイン アカウントの組織単位 (OU) を指定します。 OU の完全識別名を引用符で囲んで入力します。 既定値は、ドメイン内で使用されるコンピューター オブジェクトの既定の OU です。
Type: | String |
Aliases: | OU |
Position: | Named |
Default value: | The default OU for machine objects for in the domain |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Restart
ドメインまたはワークグループに追加されたコンピューターを再起動します。 多くの場合、変更を有効にするには再起動が必要です。
このパラメーターは、Windows PowerShell 3.0 で導入されました。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Server
ドメインにコンピューターを追加するドメイン コントローラーの名前を指定します。 ドメイン名\コンピューター名の形式で入力します。 既定では、ドメイン コントローラーは指定されません。
Type: | String |
Aliases: | DC |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnjoinDomainCredential
コンピューターを現在のドメインから削除するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
「User01」や「Domain01\User01」のようなユーザー名を入力するか、 コマンドレットで生成されるような Get-Credential
オブジェクトを入力します。
ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。
このパラメーターは、コンピューターを別のドメインに移動するときに使用します。 新しいドメインに参加するアクセス許可を持つユーザー アカウントを指定するには、Credential パラメーターを使用します。 リモート コンピューターに接続するアクセス許可を持つユーザー アカウントを指定するには、LocalCredential パラメーターを使用します。
このパラメーターは、Windows PowerShell 3.0 で導入されました。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Unsecure
指定されたドメインへのセキュリティで保護されていない参加を行います。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
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" です。
Type: | String |
Aliases: | WGN |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
コンピューター名と新しい名前をコマンドレットに Add-Computer
パイプできます。
出力
PassThru パラメーターを使用すると、 Add-Computer
ComputerChangeInfo オブジェクトが返されます。
それ以外の場合、このコマンドレットによる出力はありません。
メモ
- Windows PowerShell 2.0 では、 の Server パラメーター
Add-Computer
は、サーバーが存在する場合でも失敗します。 Windows PowerShell 3.0 では、Server パラメーターが確実に動作するように実装が変更されました。