将本地计算机添加到域或工作组中。
语法
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 的参数来指定组织单位 (OU) 和域控制器，或执行不安全的加入。
要获取此命令的结果，请使用 Verbose 和 PassThru 参数。
参数
-Credential <PSCredential>
指定有权执行此操作的用户帐户。默认值为当前用户。
键入用户名，如“User01”或“Domain01\User01”；或输入 PSCredential 对象，如 Get-Credential cmdlet 生成的一个 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 参数生成有关命令结果的简要报告。
另请参阅