Get-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 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.
Sintaxe
Identity
Get-MigrationBatch
[[-Identity] <MigrationBatchIdParameter>]
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DiagnosticInfo <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-Partition <MailboxIdParameter>]
[-ResultSize <Unlimited>]
[-Status <MigrationBatchStatus>]
[<CommonParameters>]
BatchesFromEndpoint
Get-MigrationBatch
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-Endpoint <MigrationEndpointIdParameter>]
[-IncludeReport]
[-Status <MigrationBatchStatus>]
[<CommonParameters>]
BatchesByEndpoint
Get-MigrationBatch
[-DiagnosticInfo <String>]
[-Endpoint <MigrationEndpointIdParameter>]
[-IncludeReport]
[-Partition <MailboxIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
BatchesByStatus
Get-MigrationBatch
[-DiagnosticInfo <String>]
[-IncludeReport]
[-Partition <MailboxIdParameter>]
[-ResultSize <Unlimited>]
[-Status <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 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.
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 contêm o mesmo valor (e também 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 sua 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.
Exemplo 3
Get-MigrationBatch -Status Syncing
Este exemplo exibe todos os lotes de migração que têm o valor de status Sincronizando.
Parâmetros
-Diagnostic
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesFromEndpoint
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DiagnosticArgument
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 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesFromEndpoint
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DiagnosticInfo
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
Normalmente, você usa o parâmetro DiagnosticInfo somente a pedido do Serviço de Suporte e Atendimento ao Cliente Microsoft para solucionar problemas. Os valores válidos são:
- attachmentid=String
- batch=String
- Confirme
- duration=String
- pontos de extremidade
- endtime=DateTime
- maxsize=Int32
- organization=String
- partition=String
- reportid=String
- Power BI
- Linha do Tempo do Show
- showtimeslots=String
- starttime=DateTime
- status=String
- armazenamento
- type=String
- user=String
- detalhado
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesByEndpoint
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesByStatus
| 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
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesFromEndpoint
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Endpoint
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | MigrationEndpointIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
BatchesFromEndpoint
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesByEndpoint
| 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 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.
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | MigrationBatchIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeReport
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
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 |
-Partition
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro Partition filtra os resultados para lotes de migração que foram criados em uma caixa de correio de partição de migração específica. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesByEndpoint
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesByStatus
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResultSize
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesByEndpoint
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesByStatus
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Status
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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
- Concluindo
- Corrompidos
- Criado
- Falhou
- IncrementalSyncing
- Removendo
- Iniciando
- Parado
- Sincronização
- Parando
- Sincronizados
- SyncedwithErrors
- Aguardando
Propriedades do parâmetro
| Tipo: | MigrationBatchStatus |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesFromEndpoint
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
BatchesByStatus
| 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, 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.