Share via


New-CMComputerAssociation

Cria uma associação entre dois computadores no Configuration Manager.

Syntax

New-CMComputerAssociation
   -DestinationComputer <String>
   [-MigrationBehavior <MigrationBehavior>]
   [-MigrationUserName <String[]>]
   -SourceComputer <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-CMComputerAssociation cria uma associação entre dois computadores a ser usado 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.

Para criar uma associação, especifique o computador de origem, o computador de destino e pelo menos um nome de usuário criado no computador de origem a ser migrado. Você também pode especificar se a migração 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: Criar uma associação de computador

PS XYZ:\> New-CMComputerAssociation -SourceComputer "TSQA073" -MigrationUserName "Contoso-TSQA\ElisaDaugherty" -DestinationComputer "TSQA155"

Este comando cria uma associação de computador entre o computador de origem chamado TSQA073 e o computador de destino chamado TSQA155. O comando especifica um nome de usuário para migração para o computador de destino.

Parâmetros

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

Se você não especificar um comportamento de migração, a migração usará CaptureAndRestoreAllUserAccounts.

Type:MigrationBehavior
Accepted values:CaptureAndRestoreAllUserAccounts, CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MigrationUserName

Especifica uma matriz de nomes de usuário para contas criadas no computador de origem. Os nomes de usuário especificados, juntamente com a configuração do parâmetro MigrationBehavior, determinam quais contas de usuário o Configuration Manager cria no computador de destino.

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

IResultObject