將本機電腦加入至網域或工作群組。

語法

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

預設值

Current User Account Credentials

接受管線輸入?

false

接受萬用字元?

false

-DomainName <string>

指定電腦帳戶的網域。此參數為必要項。

必要?

true

位置?

2

預設值

接受管線輸入?

false

接受萬用字元?

false

-OUPath <string>

指定網域帳戶的組織單位 (OU)。輸入 OU 的完整分辨名稱。預設值為網域中電腦物件的預設 OU。

必要?

false

位置?

named

預設值

The default OU for machine objects for in the domain

接受管線輸入?

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 參數,產生命令結果的簡要報告。






請參閱




目錄