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
、ローカル コンピューターまたはリモート コンピューターを doメイン またはワークグループに追加するか、doメイン を別のコンピューターに移動します。 また、アカウントなしでドメインに追加されたコンピューターのドメイン アカウントも作成します。
このコマンドレットのパラメーターを使用して、組織単位 (OU) およびドメイン コントローラーを指定したり、セキュリティで保護されていない参加を実行したりすることができます。
コマンドの結果を取得するには、Verbose パラメーターと PassThru パラメーターを使用します。
例
例 1: Do にローカル コンピューターを追加メインコンピューターを再起動する
Add-Computer -DomainName Domain01 -Restart
このコマンドは、ローカル コンピューターを Domain01 ドメインに追加し、コンピューターを再起動して変更を有効にします。
例 2: ワークグループにローカル コンピューターを追加する
Add-Computer -WorkgroupName WORKGROUP-A
このコマンドは、ローカル コンピューターを Workgroup-A ワークグループに追加します。
例 3: do にローカル コンピューターを追加するメイン
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose
このコマンドは、Domain01\DC01 ドメイン コントローラーを使用して、ローカル コンピューターを Domain01 ドメインに追加します。
このコマンドでは、 PassThru パラメーターと Verbose パラメーターを使用して、コマンドの結果に関する詳細情報を取得します。
例 4: OUPath パラメーターを使用してローカル コンピューターを doメイン に追加する
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"
このコマンドは、ローカル コンピューターを Domain02 ドメインに追加します。 OUPath パラメーターを使用して、新しいアカウントの組織単位を指定します。
例 5: 資格情報を使用してローカル コンピューターを doメイン に追加する
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -Force
このコマンドは、Server01 コンピューターを Domain02 ドメインに追加します。 LocalCredential パラメーターを使用して、Server01 コンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 Credential パラメーターを使用して、コンピューターを doメイン に参加させるアクセス許可を持つユーザー アカウントを指定します。 参加操作の完了後に Restart パラメーターを使用してコンピューターを再起動し、Force パラメーターを使用してユーザー確認メッセージを抑制します。
例 6: コンピューターのグループを新しい do に移動するメイン
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -Restart
このコマンドは、Server01、Server02、およびローカル コンピューターを Domain01 から Domain02 に移動します。
LocalCredential パラメーターを使用して、影響を受ける 3 台のコンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 UnjoinDoメインCredential パラメーターを使用して、Doメイン01 doメイン からコンピューターの参加を解除するアクセス許可を持つユーザー アカウントを指定し、Credential パラメーターを使用して、コンピューターを Doメイン02 doメイン に参加させるアクセス許可を持つユーザー アカウントを指定します。 移動が完了した後、 Restart パラメーターを使用して 3 台のコンピューターすべてを再起動します。
例 7: コンピューターを新しい do に移動しメインコンピューターの名前を変更する
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -Restart
このコマンドは、Server01 コンピューターを Domain02 に移動し、コンピューター名を Server044 に変更します。
Server01 コンピューターへの接続には現在のユーザーの資格情報を使用し、このコンピューターを現在のドメインから削除します。 Credential パラメーターを使用して、コンピューターを Doメイン02 doメイン に参加させるアクセス許可を持つユーザー アカウントを指定します。
例 8: ファイルに一覧表示されているコンピューターを新しい do に追加するメイン
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -Restart
このコマンドは、ファイルに一覧表示されているコンピューターを Servers.txt
Doメイン02 doメイン に追加します。 Options パラメーターを使用して Win9xUpgrade オプションを指定します。 Restart パラメーターは、参加操作が完了した後、新しく追加されたすべてのコンピューターを再起動します。
例 9: 定義済みのコンピューター資格情報を使用してメインコンピューターを do に追加する
この最初のコマンドは、既に参加しているコンピューターから管理者が実行する必要がありますメイン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
このコマンドの組み合わせにより、既存の doメイン 参加済みコンピューターを使用して、doメイン に定義済みの名前と一時参加パスワードを持つ新しいコンピューター アカウントが作成されます。 その後、定義済みの名前を持つコンピューターは、コンピューター名と一時参加パスワードのみを使用してメイン do を結合します。 定義済みのパスワードは、参加操作をサポートするためにのみ使用され、コンピューターが参加を完了した後、通常のコンピューター アカウントの手順の一部として置き換えられます。
パラメーター
-ComputerName
ドメインまたはワークグループに追加するコンピューターを指定します。 既定値はローカル コンピューターです。
各リモート コンピューターの NetBIOS 名、インターネット プロトコル (IP) アドレス、または完全修飾ドメイン名を入力します。 ローカル コンピューターを指定するには、コンピューター名、ドット (.
)、または "localhost" を入力します。
このパラメーターは、Windows PowerShell リモート処理に依存しません。 コンピューターがリモート コマンドを 実行するように構成されていない場合でも、ComputerName パラメーター Add-Computer
を使用できます。
このパラメーターは、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" や "Doメイン01\User01" などのユーザー名を入力するか、PSCredential オブジェクト (コマンドレットによってGet-Credential
生成されたものなど) を入力します。 ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。
コンピューターを現在の do から削除するアクセス許可を持つユーザー アカウントを指定するにはメインUnjoinDoメインCredential パラメーターを使用します。 リモート コンピューターに接続するアクセス許可を持つユーザー アカウントを指定するには、LocalCredential パラメーターを使用します。
Type: | PSCredential |
Aliases: | DomainCredential |
Position: | Named |
Default value: | None |
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" や "Doメイン01\User01" などのユーザー名を入力するか、PSCredential オブジェクト (コマンドレットによってGet-Credential
生成されたものなど) を入力します。 ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。
コンピューターを新しい do に追加するアクセス許可を持つユーザー アカウントを指定するにはメイン Credential パラメーターを使用します。 コンピューターを現在の do から削除するアクセス許可を持つユーザー アカウントを指定するにはメインUnjoinDoメインCredential パラメーターを使用します。
このパラメーターは、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
結合操作の詳細オプションを Add-Computer
指定します。 1 つ以上の値をコンマ区切りの文字列として入力します。
このパラメーターの有効値は、次のとおりです。
AccountCreate: doメイン アカウントを作成します。 コマンドレットは
Add-Computer
、コンピューターを doメイン に追加すると、doメイン アカウントを自動的に作成します。 このオプションは、完全性を高める目的で含まれています。Win9XUpgrade: 参加操作が Windows オペレーティング システムのアップグレードの一部であることを示します。
UnsecuredJoin: セキュリティで保護されていない結合を実行します。 セキュリティで保護されていない結合を要求するには、セキュリティで保護されていないパラメーターまたはこのオプションを使用します。 マシンパスワードを渡す場合は、このオプションをオプションと
PasswordPass
組み合わせて使用する必要があります。PasswordPass: セキュリティで保護されていない結合を実行した後、コンピューターのパスワードを Credential(DoメインCredential) パラメーターの値に設定します。 また、このオプションは、Credential (DoメインCredential) パラメーターの値がユーザー パスワードではなくマシン パスワードであることを示します。 このオプションは、オプションが
UnsecuredJoin
指定されている場合にのみ有効です。 このオプションを使用する場合、パラメーターに-Credential
指定する資格情報には null ユーザー名が必要です。JoinWithNewName: new do のコンピューター名の名前をメイン NewName パラメーターで指定された名前に変更します。 NewName パラメーターを使用すると、このオプションが自動的に設定されます。 このオプションは、Rename-Computer コマンドレットで使用するように設計されています。 コマンドレットを
Rename-Computer
使用してコンピューターの名前を変更しても、コンピューターを再起動して変更を有効にしない場合は、このパラメーターを使用して、コンピューターを新しい名前で doメイン に参加させることができます。JoinReadOnly: 既存のコンピューター アカウントを使用して、コンピューターを読み取り専用の doメイン コントローラーに参加させます。 パスワード レプリケーション ポリシーの許可リストにマシン アカウントを追加し、アカウント パスワードを、参加操作の前に読み取り専用の doメイン コントローラーにレプリケートする必要があります。
InstallInvoke: JoinDoメインOrWorkgroup メソッドの FJoinOptions パラメーターの作成 (0x2) フラグと削除 (0x4) フラグを設定します。 JoinDoメインOrWorkgroup メソッドの詳細については、「Win32_ComputerSystem クラスの JoinDoメインOrWorkgroup メソッド」を参照してください。 これらのオプションの詳細については、「NetJoinDoメイン 関数」を参照してください。
このパラメーターは 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: | 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
ドメインまたはワークグループに追加されたコンピューターを再起動します。 多くの場合、変更を有効にするには再起動が必要です。
このパラメーターは、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" や "Doメイン01\User01" などのユーザー名を入力するか、PSCredential オブジェクト (コマンドレットによってGet-Credential
生成されたものなど) を入力します。 ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。
このパラメーターは、コンピューターを別のドメインに移動するときに使用します。 新しい do に参加するアクセス許可を持つユーザー アカウントを指定するにはメイン 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: | 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" です。
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 パラメーターの実装が変更され、確実に動作します。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback。
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください:フィードバックの送信と表示