Set-CMComputerAssociation
Altera as configurações de uma associação de computador no 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
O cmdlet Set-CMComputerAssociation altera as configurações de uma associação de computador usada para migração. O Configuration Manager pode migrar o estado do usuário e as configurações de um computador existente para um computador diferente como parte da implantação do sistema operacional. Durante a migração, o Configuration Manager salva contas criadas no computador de origem e cria essas contas de usuário no computador de destino.
Uma associação de computador contém os nomes de usuário a serem migrados e como lidar com outros nomes de usuário do computador de origem. Você pode usar esse cmdlet para modificar uma associação. Você pode adicionar nomes de usuário à associação ou remover nomes de usuário. Você também pode alterar se o Configuration Manager inclui outros nomes de usuário do computador de origem.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
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"
Esse comando altera a associação entre o computador chamado TSQA073 e o TSQA155. O comando adiciona o usuário ContosoTSQA\EvanNarvaez e remove o usuário ContosoTSQA\ElisaDaugherty. O comando especifica o comportamento de migração como CaptureAllUserAccountsAndRestoreSpecifiedAccounts, portanto, a associação faz com que a migração salve todas as contas criadas no computador de origem, mas apenas para criar as contas especificadas pela associação do computador no computador de destino.
Parâmetros
-AddMigrationUserName
Especifica uma matriz de nomes de usuário para contas criadas no computador de origem. O cmdlet adiciona esses nomes de usuário aos nomes de usuário especificados atuais da associação de computadores.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationComputer
Especifica o nome de um computador de destino.
Type: | String |
Aliases: | RestoreName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MigrationBehavior
Especifica como o Configuration Manager trata as contas de usuário criadas no computador de origem. Ao criar uma associação de computador, especifique contas de usuário criadas no computador de origem usando o parâmetro MigrationUserName do cmdlet New-CMComputerAssociation. A associação do computador 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. Salva todas as contas criadas no computador de origem, mas cria apenas as contas especificadas no computador de destino.
- CaptureAndRestoreAllUserAccounts. Salva todas as contas criadas no computador de origem e as cria no computador de destino.
- CaptureAndRestoreSpecifiedUserAccounts. Salva apenas as contas especificadas do computador de origem e cria essas contas no computador 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 uma matriz de nomes de usuário para contas criadas no computador de origem. O cmdlet remove esses nomes de usuário dos nomes de usuário especificados atuais da associação de computadores.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceComputer
Especifica o nome do computador de origem.
Type: | String |
Aliases: | SourceName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Nenhum
Saídas
System.Object