Set-CMComputerAssociation

更改 Configuration Manager 中计算机关联的设置。

语法

Set-CMComputerAssociation
   [-AddMigrationUserName <String[]>]
   -DestinationComputer <String>
   [-MigrationBehavior <MigrationBehavior>]
   [-RemoveMigrationUserName <String[]>]
   -SourceComputer <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMComputerAssociation
   [-AddMigrationUserName <String[]>]
   [-MigrationBehavior <MigrationBehavior>]
   -MigrationId <String>
   [-RemoveMigrationUserName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

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

计算机关联包含要迁移的用户名以及如何处理源计算机中的其他用户名。 可以使用此 cmdlet 修改关联。 可以将用户名添加到关联中,或删除用户名。 还可以更改 Configuration Manager 是否包括源计算机中的其他用户名。

注意

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

示例

示例 1:修改计算机关联

PS XYZ:\> Set-CMComputerAssociation -DestinationComputer "TSQA155" -SourceComputer "TSQA073" -AddMigrationUserName "ContosoTSQA\EvanNarvaez" -MigrationBehavior CaptureAllUserAccountsAndRestoreSpecifiedAccounts -RemoveMigrationUserName "ContosoTSQA\ElisaDaugherty"

此命令更改名为 TSQA073 和 TSQA155 的计算机之间的关联。 命令添加用户 ContosoTSQA\EvanNarvaez 并删除用户 ContosoTSQA\ElisaDaugherty。 命令将迁移行为指定为 CaptureAllUserAccountsAndRestoreSpecifiedAccounts,因此该关联会导致迁移保存在源计算机上创建的所有帐户,但只会在目标计算机上创建由计算机关联指定的帐户。

参数

-AddMigrationUserName

指定在源计算机上创建的帐户的用户名数组。 cmdlet 将这些用户名添加到计算机关联的当前指定用户名中。

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

-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 如何处理在源计算机上创建的用户帐户。 创建计算机关联时,使用 New-CMComputerAssociation cmdlet 的 MigrationUserName 参数指定在源计算机上创建的用户帐户。 计算机关联可以指定迁移过程在目标计算机上创建部分或所有这些帐户。

此参数可接受的值为:

  • CaptureAllUserAccountsAndRestoreSpecifiedAccounts。 保存在源计算机上创建的所有帐户,但仅在目标计算机上创建指定的帐户。
  • CaptureAndRestoreAllUserAccounts。 保存在源计算机上创建的所有帐户,并在目标计算机上创建帐户。
  • CaptureAndRestoreSpecifiedUserAccounts。 仅保存源计算机中的指定帐户,并在目标计算机上创建这些帐户。
类型:MigrationBehavior
接受的值:CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MigrationId

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

-RemoveMigrationUserName

指定在源计算机上创建的帐户的用户名数组。 cmdlet 从计算机关联的当前指定用户名中删除这些用户名。

类型: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

输出

System.Object