Add-Computer

Add-Computer cmdlet 將本地計算機添加到域或工作組中，或將其從一個域移至另一個域。它還為添加到域中的無帳戶計算機創建域帳戶。

基本介紹

• 中文名：Add-Computer
• 語法：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>]

說明

可以使用此 cmdlet 的參數來指定組織單位 (OU) 和域控制器，或執行不安全的加入。

要獲取此命令的結果，請使用 Verbose 和 PassThru 參數。

參數

-Credential <PSCredential>

指定有權執行此操作的用戶帳戶。默認值為當前用戶。

鍵入用戶名，如“User01”或“Domain01\User01”；或輸入 PSCredential 對象，如Get-Credentialcmdlet 生成的一個 PSCredential 對象。如果鍵入用戶名，則將提示您輸入密碼。

是否為必需？

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 所返回對象的類型。

輸入

None

不能通過管道將對象傳遞給 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