Add-Computer

项目
10/30/2009

将本地计算机添加到域或工作组中。

语法

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
默认值	当前用户帐户凭据
是否接受管道输入？	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

通过