Add-Computer
將本機電腦加入至網域或工作群組。
語法
Add-Computer [-DomainName] <string> [-Credential <PSCredential>] [-OUPath <string>] [-Server <string>] [-Unsecure] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Add-Computer [-WorkGroupName] <string> [-Credential <PSCredential>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
描述
Add-Computer Cmdlet 會將本機電腦加入至網域或工作群組，或是在不同的網域之間移動本機電腦。如果該電腦已加入至沒有帳戶的網域，此 Cmdlet 也會建立網域帳戶。
您可以使用這個 Cmdlet 的參數，指定組織單位 (OU) 與網域控制站，或是執行未受安全保護的加入。
若要取得命令的結果，請使用 Verbose 與 PassThru 這兩個參數。
參數
-Credential <PSCredential>
指定具有執行此動作之權限的使用者帳戶。預設為目前使用者。
請輸入使用者名稱，例如 "User01" 或 "Domain01\User01"，或是輸入 PSCredential 物件，例如由 Get-Credential Cmdlet 所產生的物件。如果輸入使用者名稱，則系統會提示您提供密碼。
必要? |
false |
位置? |
named |
預設值 |
目前的使用者帳戶憑證 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-DomainName <string>
指定電腦帳戶的網域。此參數為必要項。
必要? |
true |
位置? |
2 |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-OUPath <string>
指定網域帳戶的組織單位 (OU)。輸入 OU 的完整分辨名稱。預設值為網域中電腦物件的預設 OU。
必要? |
false |
位置? |
named |
預設值 |
網域中電腦物件的預設 OU |
接受管線輸入? |
false |
接受萬用字元? |
false |
-PassThru
傳回命令的結果。根據預設，此 Cmdlet 不會產生任何輸出。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Server <string>
指定會將電腦新增到網域之網域控制站的名稱。以 DomainName\ComputerName 的格式，輸入名稱。預設為本機電腦。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Unsecure
執行未受安全保護的加入。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-WorkGroupName <string>
指定電腦的工作群組名稱。如果省略這個參數，則電腦會加入到網域中。
必要? |
true |
位置? |
3 |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Confirm
在執行命令前先提示確認。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-WhatIf
說明執行命令時將會發生何種情況，但不會實際執行命令。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
輸入 |
無 您無法透過管道將物件傳遞給 Add-Computer。 |
輸出 |
Microsoft.PowerShell.Commands.ComputerChangeInfo 當您使用 PassThru 參數時，Add-Computer 會傳回 ComputerChangeInfo 物件。否則，這個 Cmdlet 不會產生任何輸出。 |
範例 1
C:\PS>add-computer -domainname Domain01; restart-computer
描述
-----------
這些命令會使用目前使用者的認證，將本機電腦加入至 Domain01 網域。
第一個命令會將此電腦加入至網域。第二個命令會使用 Restart-Computer Cmdlet 重新啟動電腦，這樣就會完成加入作業。分號 (;) 會分隔兩個命令。
範例 2
C:\PS>add-computer -workgroupname WORKGROUP-A
描述
-----------
這個命令會將本機電腦加入至 Workgroup-A 工作群組。
範例 3
C:\PS>add-computer -DomainName Domain01 -Server Domain01\DC01 -passthru -verbose
描述
-----------
這個命令會使用 Domain01\DC01 網域控制站，將本機電腦加入至 Domain01 網域。
這個命令使用 PassThru 與 Verbose 這兩個參數，取得命令結果的詳細資訊。
範例 4
C:\PS>Add-Computer -domainname Domain02 -OUPath OU=testOU,DC=domain,DC=Domain,DC=com
描述
-----------
這個命令會將 Server01 與 Server02 電腦加入 Domain02 網域。該命令還會使用 OUPath 命令，指定新帳戶的組織單位。
範例 5
C:\PS>Add-Computer -domainname Domain02 -cred Domain02\Admin02 -passthru
描述
-----------
這個命令會使用網域系統管理員的認證，將本機電腦加入至 Domain02 網域。這個命令使用 PassThru 參數，產生命令結果的簡要報告。
請參閱
概念
Checkpoint-Computer
Remove-Computer
Restart-Computer
Restore-Computer
Stop-Computer
Test-Connection