Get-MigrationBatch

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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 ou outro ambiente.

Use o cmdlet Get-MigrationBatch para recuperar informações de status sobre o lote de migração atual.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-MigrationBatch
   [-Endpoint <MigrationEndpointIdParameter>]
   [-Diagnostic]
   [-DiagnosticArgument <String>]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-IncludeReport]
   [-Partition <MailboxIdParameter>]
   [-Status <Microsoft.Exchange.Data.Storage.Management.MigrationBatchStatus>]
   [<CommonParameters>]
Get-MigrationBatch
   [[-Identity] <MigrationBatchIdParameter>]
   [-Diagnostic]
   [-DiagnosticArgument <String>]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-IncludeReport]
   [-Partition <MailboxIdParameter>]
   [-Status <Microsoft.Exchange.Data.Storage.Management.MigrationBatchStatus>]
   [<CommonParameters>]

Description

O cmdlet Get-MigrationBatch exibe informações de status sobre o lote de migração atual. Essas informações incluem:

  • Status do lote de migração
  • Número total de caixas de correio que estão sendo migradas
  • Número de migrações concluídas com êxito
  • Os erros de migração
  • Data e hora em que a migração foi iniciada e concluída.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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.

Observação: no serviço baseado em nuvem, se você não usar o parâmetro TimeZone no comando New-MigrationBatch, o fuso horário padrão para o lote de migração será UTC. As propriedades CompleteAfter e CompleteAfterUTC conterão o mesmo valor (assim como as propriedades StartAfter e StartAfterUTC). Quando você cria o lote de migração no Centro de Administração do Exchange (EAC), o fuso horário usado é baseado na configuração regional.

Exemplos

Exemplo 1

Get-MigrationBatch -Identity LocalMove2

Este exemplo mostra informações de status sobre o lote de migração LocalMove2.

Exemplo 2

Get-MigrationBatch -Endpoint exsrv1.contoso.com

Este exemplo mostra informações sobre todos os lotes de migração associados ao ponto de extremidade de migração exsrv1.contoso.com.

Parâmetros

-Diagnostic

Este parâmetro está disponível somente no Exchange local.

A opção Diagnostic especifica quando é necessário retornar informações extremamente detalhadas nos resultados. Não é preciso especificar um valor com essa opção.

Normalmente, você usa essa opção somente por solicitação do Suporte e Atendimento ao Cliente Microsoft para solucionar problemas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DiagnosticArgument

Este parâmetro está disponível somente no Exchange local.

O parâmetro DiagnosticArgument modifica os resultados retornados usando a opção Diagnostic. Normalmente, você usa a opção Diagnostic e o parâmetro DiagnosticArgument somente por solicitação do Serviço de Suporte e Atendimento ao Cliente Microsoft para solucionar problemas.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DiagnosticInfo

Esse parâmetro só está disponível no serviço baseado em nuvem.

Normalmente, você usa o parâmetro DiagnosticInfo somente a pedido de Microsoft Serviço ao Cliente e suporte para solucionar problemas. Os valores válidos são:

  • attachmentid=String
  • batch=String
  • Confirmar
  • duration=String
  • pontos de extremidade
  • endtime=DateTime
  • maxsize=Int32
  • organization=String
  • partition=String
  • reportid=String
  • Relatórios
  • showtimeline
  • showtimeslots=String
  • starttime=DateTime
  • status=Cadeia de Caracteres
  • Armazenamento
  • type=String
  • user=String
  • Verbose
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Endpoint

O parâmetro Endpoint retorna uma lista de lotes de migração associados ao ponto de extremidade de migração especificado.

Se você usar esse parâmetro, não poderá incluir o parâmetro Identity.

Type:MigrationEndpointIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

O parâmetro Identity identifica o nome do lote de migração atual. O valor desse parâmetro é especificado pelo parâmetro Name do cmdlet New-MigrationBatch.

Se você usar esse parâmetro, não poderá incluir o parâmetro Endpoint.

Type:MigrationBatchIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeReport

A opção IncludeReport retorna informações adicionais sobre o lote de migração especificado. Não é preciso especificar um valor com essa opção.

Essa informação é exibida no campo Report.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Partition

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Status

O parâmetro Status retorna uma lista de lotes de migração que têm o status de estado especificado. Use um dos valores a seguir:

  • Concluído
  • CompletedWithErrors
  • Completar
  • Corrompido
  • Criado
  • Falhou
  • IncrementalSyncing
  • Remover
  • Iniciando
  • Parado
  • Sincronizando
  • Parar
  • Sincronizados
  • SyncedwithErrors
  • Esperando
Type:Microsoft.Exchange.Data.Storage.Management.MigrationBatchStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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, isso significa que 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 retorna dados.