Set-CMComputerAssociation
Altera as definições de uma associação de computadores no Configuration Manager.
Sintaxe
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
O cmdlet Set-CMComputerAssociation altera as definições de uma associação de computador utilizada para migração. O Configuration Manager pode migrar o estado e as definições do utilizador de um computador existente para um computador diferente como parte da implementação do sistema operativo. No decurso da migração, o Configuration Manager guarda as contas criadas no computador de origem e cria essas contas de utilizador no computador de destino.
Uma associação de computadores contém os nomes de utilizador a serem migrados e como lidar com outros nomes de utilizador do computador de origem. Pode utilizar este cmdlet para modificar uma associação. Pode adicionar nomes de utilizador à associação ou remover nomes de utilizador. Também pode alterar se o Configuration Manager inclui outros nomes de utilizador do computador de origem.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Modificar uma associação de computador
PS XYZ:\> Set-CMComputerAssociation -DestinationComputer "TSQA155" -SourceComputer "TSQA073" -AddMigrationUserName "ContosoTSQA\EvanNarvaez" -MigrationBehavior CaptureAllUserAccountsAndRestoreSpecifiedAccounts -RemoveMigrationUserName "ContosoTSQA\ElisaDaugherty"Este comando altera a associação entre o computador com o nome TSQA073 e TSQA155. O comando adiciona o utilizador ContosoTSQA\EvanNarvaez e remove o utilizador ContosoTSQA\ElisaDaugherty. O comando especifica o comportamento de migração como CaptureAllUserAccountsAndRestoreSpecifiedAccounts, pelo que a associação faz com que a migração guarde todas as contas criadas no computador de origem, mas apenas para criar as contas especificadas pela associação de computador no computador de destino.
Parâmetros
-AddMigrationUserName
Especifica uma matriz de nomes de utilizador para contas criadas no computador de origem. O cmdlet adiciona estes nomes de utilizador aos nomes de utilizador especificados atuais da associação de computadores.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DestinationComputer
Especifica o nome de um computador de destino.
| Tipo: | String |
| Aliases: | RestoreName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MigrationBehavior
Especifica como o Configuration Manager trata as contas de utilizador criadas no computador de origem. Quando cria uma associação de computador, especifique as contas de utilizador criadas no computador de origem com o parâmetro MigrationUserName do cmdlet New-CMComputerAssociation . A associação de computadores pode especificar que o processo de migração cria algumas ou todas essas contas no computador de destino.
Os valores aceitáveis para esse parâmetro são:
- CaptureAllUserAccountsAndRestoreSpecifiedAccounts. Guarda todas as contas criadas no computador de origem, mas cria apenas as contas especificadas no computador de destino.
- CaptureAndRestoreAllUserAccounts. Guarda todas as contas criadas no computador de origem e cria-as no computador de destino.
- CaptureAndRestoreSpecifiedUserAccounts. Guarda apenas as contas especificadas do computador de origem e cria essas contas no computador de destino.
| Tipo: | MigrationBehavior |
| Valores aceitos: | CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MigrationId
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RemoveMigrationUserName
Especifica uma matriz de nomes de utilizador para contas criadas no computador de origem. O cmdlet remove estes nomes de utilizador dos nomes de utilizador especificados atuais da associação de computadores.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SourceComputer
Especifica o nome do computador de origem.
| Tipo: | String |
| Aliases: | SourceName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None
Saídas
System.Object