Add-Computer
將本機電腦新增到網域或工作群組。
Syntax
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>]Description
Cmdlet Add-Computer 會將本機計算機或遠端電腦新增至網域或工作組，或將它們從一個網域移至另一個網域。
如果將電腦新增到網域時沒有帳戶，它也會一併建立網域帳戶。
您可以使用這個 Cmdlet 的參數來指定組織單位 (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 參數來指定具有連線到這三部受影響電腦之權限的使用者帳戶。 它使用 UnjoinDomainCredential 參數來指定具有將電腦從 Domain01 網域退出之權限的使用者帳戶，並且使用 Credential 參數來指定具有將電腦加入 Domain02 網域之權限的使用者帳戶。 它使用 Restart 參數，以在完成移動後重新啟動這三部電腦。
範例 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 遠端功能。
即使您的電腦未設定為執行遠端命令，您也可以使用 的 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
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
指定具有將電腦加入新網域之權限的使用者帳戶。 預設為目前使用者。
輸入使用者名稱，例如 「User01」 或 「Domain01\User01」，或輸入 PSCredential 物件，例如 Cmdlet 所產生的 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」，或輸入 PSCredential 物件，例如 Cmdlet 所產生的 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
指定新網域中電腦的新名稱。 這個參數只有在新增或移除電腦時才有效。
此參數是在 Windows PowerShell 3.0 引進。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Options
指定 Add-Computer 聯結作業的進階選項。 請以逗號分隔的字串方式輸入一個或多個值。
此參數可接受的值為：
AccountCreate：建立網域帳戶。 Add-Computer Cmdlet 會在將電腦新增至網域時自動建立網域帳戶。 此選項包含在完整性中。
Win9XUpgrade：指出聯結作業是 Windows 操作系統升級的一部分。
UnsecuredJoin：執行不安全的聯結。 若要要求不安全的聯結，請使用 [不安全 ] 參數或此選項。
PasswordPass：在執行不安全的聯結之後，將計算機密碼設定為 Credential (DomainCredential) 參數的值。 這個選項也會指出 Credential (DomainCredential) 參數的值是電腦密碼，而不是使用者密碼。 這個選項只有在指定了 UnsecuredJoin 選項時才有效。
-- JoinWithNewName：將新網域中的計算機名稱重新命名為 NewName 參數所指定的名稱。 使用 NewName 參數時，會自動設定這個選項。 此選項的設計目的是要與 Rename-Computer Cmdlet 搭配使用。 如果您使用 Rename-Computer Cmdlet 來重新命名電腦，但不要重新啟動電腦，使變更生效，您可以使用此參數將電腦加入具有新名稱的網域。
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
傳回代表您正在使用之項目的物件。 根據預設，此 Cmdlet 不會產生任何輸出。
| 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
指定將電腦新增到網域的網域控制站名稱。 請以 DomainName\ComputerName 格式輸入名稱。 預設不會指定任何網域控制站。
| Type: | String |
| Aliases: | DC |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnjoinDomainCredential
指定具有將電腦從其目前網域中移除之權限的使用者帳戶。 預設為目前使用者。
輸入使用者名稱，例如 「User01」 或 「Domain01\User01」，或輸入 PSCredential 物件，例如 Cmdlet 所產生的 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
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| 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 Cmdlet。
輸出
當您使用 PassThru 參數時， Add-Computer 會傳回 ComputerChangeInfo 物件。
否則，此 Cmdlet 不會產生任何輸出。
備註
- 在 Windows PowerShell 2.0 中，即使伺服器存在，的 Server 參數
Add-Computer仍會失敗。 在 Windows PowerShell 3.0 中，Server 參數的實作已變更，使其能夠可靠地運作。