Complete-MigrationBatch
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ambiente ou de outro.
Use o cmdlet Complete-MigrationBatch para finalizar um lote de migração que concluiu 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 que um lote de migração tiver sido executado com êxito e tiver uma status de Synced ou SyncedWithErrors, use 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 usuário 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 em nuvem, esse cmdlet define o valor CompleteAfter como a hora UTC atual, o que sinaliza ao serviço de migração para concluir o lote assim que possível. Isso é equivalente na intenção de executar Set-MigrationBatch -CompleteAfter (Get-Date), mas sem ambiguidade de conversão de fuso horário.
Observe o seguinte comportamento ao usar esse cmdlet no Exchange Online:
- Qualquer configuração CompleteAfter aplicada a usuários individuais dentro do lote substitui a configuração no nível do lote, portanto, a conclusão para alguns usuários pode ser adiada até o horário configurado.
- Se você executar esse cmdlet várias vezes dentro de oito horas após o lote já ter sido sinalizado para conclusão, o serviço de migração poderá não processar novamente a solicitação. Esse comportamento foi projetado para impedir que chamadas repetidas deixem o serviço de fome. Se o lote parecer travado após a execução do cmdlet, marque se há itens ignorados não aprovados (use
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 um status de Concluído com Erros, você poderá tentar finalizar novamente os usuários com falha. No Exchange Online, use o cmdlet Start-MigrationBatch para repetir a migração para usuários com falha. No Exchange 2013 ou posterior, use o Complete-MigrationBatch para repetir esses usuários com falha.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer o comando antes de continuar.
Este cmdlet tem uma pausa interna, portanto, use -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 Identity especifica o nome do lote de migração que você deseja 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 uma sincronização incremental final deve ser acionada imediatamente seguida pela conclusão do lote de migração se a sincronização for bem-sucedida. Não é preciso especificar um valor com essa opção.
Quando essa opção é usada, o lote deve ter zero itens com falha, corrompidos ou interrompidos; Caso contrário, o cmdlet retornará um erro.
Observação: Para lotes de migração de Pasta Pública, essa opção está habilitada por padrão, a menos que a opção CompletePublicFolderMigrationWithDataLoss também seja especificada.
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 mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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 retornará dados.
Observações
No Exchange Online, esse cmdlet tem suporte para os seguintes tipos de migração:
- Movimentação Local do Exchange
- Movimentação Remota do Exchange
- Gmail
- Recurso do Google
- Realocação local
- Movimentação de Pastas
- Importação de PST
- pasta pública
- Pasta pública para o Grupo Unificado
No Exchange Online, esse cmdlet não tem suporte para IMAP, Exchange Outlook em Qualquer Lugar em Estágios (substituição) ou migrações de Provisionamento em Massa, que não têm uma etapa de finalização.