Set-CMComputerAssociation
Cambia la configuración de una asociación de equipos en Configuration Manager.
Sintaxis
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 equipos usada para la migración. Configuration Manager puede migrar el estado del usuario y la configuración 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 cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Modificación de 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
-AddMigrationUserName
Especifica una matriz de nombres de usuario para las 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.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DestinationComputer
Especifica el nombre de un equipo de destino.
| Tipo: | String |
| Alias: | RestoreName |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 crea 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 desde el equipo de origen y las crea en el equipo de destino.
| Tipo: | MigrationBehavior |
| Valores aceptados: | CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MigrationId
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RemoveMigrationUserName
Especifica una matriz de nombres de usuario para las 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.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SourceComputer
Especifica el nombre del equipo de origen.
| Tipo: | String |
| Alias: | SourceName |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Salidas
System.Object