Set-CMComputerAssociation

Cambia la configuración de una asociación de equipos en Configuration Manager.

Syntax

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>]

Description

El cmdlet Set-CMComputerAssociation cambia la configuración de una asociación de equipo usada para la migración. Configuration Manager puede migrar el estado y la configuración del usuario de un equipo existente a otro equipo como parte de la implementación del sistema operativo. Durante la migración, Configuration Manager guarda las cuentas creadas en el equipo de origen y las crea en el equipo de destino.

Una asociación de equipos contiene los nombres de usuario que se van a migrar y cómo tratar con otros nombres de usuario del equipo de origen. Puede usar este cmdlet para modificar una asociación. Puede agregar nombres de usuario a la asociación o quitar nombres de usuario. También puede cambiar si Configuration Manager incluye otros nombres de usuario del equipo de origen.

Nota

Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\> . Para obtener más información, vea getting started.

Ejemplos

Ejemplo 1: Modificar una asociación de equipos

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

Este comando cambia la asociación entre el equipo denominado TSQA073 y TSQA155. El comando agrega el usuario ContosoTSQA\EvanNarvaez y quita el usuario ContosoTSQA\ElisaDaugherty. El comando especifica el comportamiento de migración como CaptureAllUserAccountsAndRestoreSpecifiedAccounts, por lo que la asociación hace que la migración guarde todas las cuentas creadas en el equipo de origen, pero solo para crear las cuentas especificadas por la asociación de equipos en el equipo de destino.

Parámetros

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-AddMigrationUserName

Especifica una matriz de nombres de usuario para cuentas creadas en el equipo de origen. El cmdlet agrega estos nombres de usuario a los nombres de usuario especificados actuales de la asociación de equipos.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DestinationComputer

Especifica el nombre de un equipo de destino.

Type:String
Aliases:RestoreName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MigrationBehavior

Especifica cómo Configuration Manager trata las cuentas de usuario creadas en el equipo de origen. Al crear una asociación de equipos, especifique las cuentas de usuario creadas en el equipo de origen mediante el parámetro MigrationUserName del cmdlet New-CMComputerAssociation. La asociación de equipos puede especificar que el proceso de migración cree algunas o todas esas cuentas en el equipo de destino.

Los valores aceptables para este parámetro son:

  • CaptureAllUserAccountsAndRestoreSpecifiedAccounts. Guarda todas las cuentas creadas en el equipo de origen, pero crea solo las cuentas especificadas en el equipo de destino.
  • CaptureAndRestoreAllUserAccounts. Guarda todas las cuentas creadas en el equipo de origen y las crea en el equipo de destino.
  • CaptureAndRestoreSpecifiedUserAccounts. Guarda solo las cuentas especificadas del equipo de origen y las crea en el equipo de destino.
Type:MigrationBehavior
Accepted values:CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MigrationId

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveMigrationUserName

Especifica una matriz de nombres de usuario para cuentas creadas en el equipo de origen. El cmdlet quita estos nombres de usuario de los nombres de usuario especificados actuales de la asociación de equipos.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SourceComputer

Especifica el nombre del equipo de origen.

Type:String
Aliases:SourceName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Ninguno

Salidas

System.Object