Complete-MigrationBatch
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Utilize o cmdlet Complete-MigrationBatch para finalizar um lote de migração que tenha concluído com êxito a sincronização inicial.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Complete-MigrationBatch
[[-Identity] <MigrationBatchIdParameter>]
[-CompletePublicFolderMigrationWithDataLoss]
[-Confirm]
[-DomainController <Fqdn>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-SyncAndComplete]
[-WhatIf]
[<CommonParameters>]
Description
Depois de um lote de migração ter sido executado com êxito e ter uma status de Synced ou SyncedWithErrors, utilize o cmdlet Complete-MigrationBatch para finalizar o lote de migração. Quando o lote de migração é concluído, o cmdlet faz o que se segue para cada caixa de correio do lote de migração:
- Executa uma sincronização incremental final.
- Configura o perfil do Microsoft Outlook do utilizador para apontar para o novo domínio de destino.
- Converte a caixa de correio de origem para um usuário habilitado para email no domínio de origem.
No serviço baseado na cloud, este cmdlet define o valor CompleteAfter como a hora UTC atual, o que sinaliza o serviço de migração para concluir o lote o mais rapidamente possível. Isto é equivalente na intenção de executar Set-MigrationBatch -CompleteAfter (Get-Date), mas sem ambiguidade de conversão do fuso horário.
Tenha em atenção o seguinte comportamento ao utilizar este cmdlet no Exchange Online:
- Qualquer definição CompleteAfter aplicada a utilizadores individuais no lote substitui a definição ao nível do lote, pelo que a conclusão de alguns utilizadores pode ser adiada até à hora configurada.
- Se executar este cmdlet várias vezes no prazo de 8 horas após o lote já ter sido sinalizado para conclusão, o serviço de migração poderá não voltar a processar o pedido. Este comportamento é por predefinição para impedir que as chamadas repetidas esfomeem o serviço. Se o lote aparecer bloqueado após executar o cmdlet, marcar para itens ignorados não aprovados (utilize
Set-MigrationUser -ApproveSkippedItems).
Quando o processo de finalização estiver concluído, é possível remover o lote usando o cmdlet Remove-MigrationBatch.
Se um lote de migração tiver uma status de Concluído com Erros, pode tentar finalizar novamente os utilizadores com falhas. No Exchange Online, utilize o cmdlet Start-MigrationBatch para repetir a migração para utilizadores com falhas. No Exchange 2013 ou posterior, utilize o Complete-MigrationBatch para repetir estes utilizadores com falhas.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Complete-MigrationBatch -Identity LocalMove1 -NotificationEmails admin@contoso.com,lucio@contoso.com
Este exemplo conclui o lote de migração LocalMove1 e envia uma mensagem de email de notificação para os usuários especificados.
Parâmetros
-CompletePublicFolderMigrationWithDataLoss
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Este cmdlet tem uma pausa incorporada, pelo que deve utilizar -Confirm:$false para ignorar a confirmação.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Identidade especifica o nome do lote de migração que pretende concluir. O valor desse parâmetro é especificado pelo parâmetro Name do cmdlet New-MigrationBatch. Use o cmdlet Get-MigrationBatch para determinar o valor deste parâmetro para o lote de migração.
Propriedades do parâmetro
| Tipo: | MigrationBatchIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-NotificationEmails
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro NotificationEmails especifica um ou mais endereços de email para os quais os relatórios de status são enviados após a conclusão do lote de migração. Você pode especificar vários endereços de email separados por vírgulas.
Se este parâmetro não for usado, o relatório final de status será enviado ao administrador que executa o cmdlet Complete-MigrationBatch.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Partition
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SyncAndComplete
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O comutador SyncAndComplete especifica se pretende acionar uma sincronização incremental final imediatamente seguida da conclusão do lote de migração se a sincronização tiver sido bem-sucedida. Não é preciso especificar um valor com essa opção.
Quando este comutador é utilizado, o lote tem de ter zero itens falhados, danificados ou parados; caso contrário, o cmdlet devolve um erro.
Nota: Para lotes de migração de Pastas Públicas, este comutador está ativado por predefinição, a menos que o comutador CompletePublicFolderMigrationWithDataLoss também esteja especificado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não devolve dados.
Observações
No Exchange Online, este cmdlet é suportado para os seguintes tipos de migração:
- Movimentação Local do Exchange
- Movimentação Remota do Exchange
- Gmail
- Recurso Google
- Reposicionamento Local
- Mover Pasta
- Importação PST
- Pasta Pública
- Pasta Pública para o Grupo Unificado
No Exchange Online, este cmdlet não é suportado para migrações IMAP, Exchange Outlook Anywhere (transferência) faseadas ou Aprovisionamento em Massa, que não têm um passo de finalização.