Add-Computer

Add-Computer
    [-DomainName] <String>
    -Credential <PSCredential>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-UnjoinDomainCredential <PSCredential>]
    [-OUPath <String>]
    [-Server <String>]
    [-Unsecure]
    [-Options <JoinOptions>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Add-Computer
    [-WorkgroupName] <String>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Add-Computer cmdlet 将本地计算机或远程计算机添加到域或工作组，或将它们从一个域移动到另一个域。 如果将计算机添加到没有帐户的域，它还会创建域帐户。

可以使用此 cmdlet 的参数来指定组织单位（OU）和域控制器，或者执行不安全的联接。

若要获取命令的结果，请使用 Verbose 和 PassThru 参数。

Add-Computer -DomainName Domain01 -Restart

此命令将本地计算机添加到 Domain01 域，然后重启计算机以使更改生效。

Add-Computer -WorkgroupName WORKGROUP-A

此命令将本地计算机添加到 Workgroup-A 工作组。

Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose

此命令使用 Domain01\DC01 域控制器将本地计算机添加到 Domain01 域。

该命令使用 PassThru 和 Verbose 参数获取有关命令结果的详细信息。

Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"

此命令将本地计算机添加到 Domain02 域。 它使用 OUPath 参数为新帐户指定组织单位。

$addComputerSplat = @{
    ComputerName = 'Server01'
    LocalCredential = 'Server01\Admin01'
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Restart = $true
    Force = $true
}
Add-Computer @addComputerSplat

此命令将 Server01 计算机添加到 Domain02 域。 它使用 LocalCredential 参数指定有权连接到 Server01 计算机的用户帐户。 它使用 Credential 参数指定有权将计算机加入域的用户帐户。 它使用 Restart 参数在联接操作完成后重新启动计算机，强制 参数禁止显示用户确认消息。

$addComputerSplat = @{
    ComputerName = 'Server01', 'Server02', 'localhost'
    DomainName = 'Domain02'
    LocalCredential = 'Domain01\User01'
    UnjoinDomainCredential = 'Domain01\Admin01'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

此命令将 Server01 和 Server02 计算机以及本地计算机从 Domain01 移动到 Domain02。

它使用 LocalCredential 参数指定有权连接到三台受影响的计算机的用户帐户。 它使用 UnjoinDomainCredential 参数指定有权从 Domain01 域取消加入计算机的用户帐户，并使用 Credential 参数指定有权将计算机加入 Domain02 域的用户帐户。 它使用 Restart 参数在移动完成后重新启动所有三台计算机。

$addComputerSplat = @{
    ComputerName = 'Server01'
    DomainName = 'Domain02'
    NewName = 'Server044'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

此命令将 Server01 计算机移动到 Domain02，并将计算机名称更改为 Server044。

该命令使用当前用户的凭据连接到 Server01 计算机，并从其当前域取消加入该计算机。 它使用 Credential 参数指定有权将计算机加入 Domain02 域的用户帐户。

$addComputerSplat = @{
    ComputerName = (Get-Content Servers.txt)
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Options = 'Win9xUpgrade'
    Restart = $true
}
Add-Computer @addComputerSplat

此命令将 Servers.txt 文件中列出的计算机添加到 Domain02 域。 它使用 Options 参数来指定 Win9xUpgrade 选项。 在联接操作完成后，Restart 参数将重新启动所有新添加的计算机。

第一个命令应由已加入域 Domain03 的计算机的管理员运行：

$newADComputerSplat = @{
    Name = "Server02"
    AccountPassword = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
}
New-ADComputer @newADComputerSplat

# Then this command is run from `Server02` which is not yet domain-joined:

$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
    UserName = $null
    Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
$addComputerSplat = @{
    DomainName = "Domain03"
    Options = 'UnsecuredJoin', 'PasswordPass'
    Credential = $joinCred
}
Add-Computer @addComputerSplat

此命令组合使用已加入域的现有计算机在域中创建一个具有预定义名称和临时加入密码的新计算机帐户。 然后，具有预定义名称的计算机仅使用该计算机名和临时加入密码加入域。 预定义的密码仅用于支持加入操作，并在计算机完成加入后作为正常创建计算机帐户过程的一部分进行替换。

使用这种命令组合可避免在计算机使用新名称加入域时为同一对象多次重新启动和多次写入 Active Directory 写入。

Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
    DomainName = 'Contoso.com'
    Credential = 'contoso\administrator'
    Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将计算机名称和新名称传递给 Add-Computer Cmdlet。

使用 PassThru 参数时，Add-Computer 返回 ComputerChangeInfo 对象。 否则，此 cmdlet 不会生成任何输出。

• 在 Windows PowerShell 2.0 中，即使服务器存在， 的 Add-Computer 参数也会失败。 在 Windows PowerShell 3.0 中，Server 参数的实现已更改，以便可靠地工作。