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