New-CMComputerAssociation

在 Configuration Manager 中的两台计算机之间创建关联。

语法

New-CMComputerAssociation
   -DestinationComputer <String>
   [-MigrationBehavior <MigrationBehavior>]
   [-MigrationUserName <String[]>]
   -SourceComputer <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-CMComputerAssociation cmdlet 在两台计算机之间创建用于迁移的关联。 Configuration Manager 可以将用户状态和设置从现有计算机迁移到其他计算机,作为操作系统部署的一部分。 在迁移过程中,Configuration Manager 会保存在源计算机上创建的帐户,并在目标计算机上创建这些用户帐户。

若要创建关联,请指定要迁移的源计算机、目标计算机以及至少一个在源计算机上创建的用户名。 还可以指定迁移是否包括源计算机中的其他用户名。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:创建计算机关联

PS XYZ:\> New-CMComputerAssociation -SourceComputer "TSQA073" -MigrationUserName "Contoso-TSQA\ElisaDaugherty" -DestinationComputer "TSQA155"

此命令在名为 TSQA073 的源计算机与名为 TSQA155 的目标计算机之间创建计算机关联。 命令指定迁移到目标计算机的用户名。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DestinationComputer

指定目标计算机的名称。

类型:String
别名:RestoreName
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MigrationBehavior

指定 Configuration Manager 如何处理在源计算机上创建的用户帐户。 创建计算机关联时,请使用 MigrationUserName 参数指定在源计算机上创建的用户帐户。 计算机关联可以指定迁移过程在目标计算机上创建部分或所有这些帐户。

此参数可接受的值为:

  • CaptureAllUserAccountsAndRestoreSpecifiedAccounts。 保存在源计算机上创建的所有帐户,但仅在目标计算机上创建指定的帐户。
  • CaptureAndRestoreAllUserAccounts。 保存在源计算机上创建的所有帐户,并在目标计算机上创建帐户。
  • CaptureAndRestoreSpecifiedUserAccounts。 仅保存源计算机中的指定帐户,并在目标计算机上创建这些帐户。

如果未指定迁移行为,则迁移将使用 CaptureAndRestoreAllUserAccounts。

类型:MigrationBehavior
接受的值:CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MigrationUserName

指定在源计算机上创建的帐户的用户名数组。 指定的用户名以及 MigrationBehavior 参数设置决定了 Configuration Manager 在目标计算机上创建的用户帐户。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SourceComputer

指定源计算机的名称。

类型:String
别名:SourceName
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

IResultObject