Get-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.
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, 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.
Nota: no serviço baseado na cloud, se não utilizar o parâmetro TimeZone no comando New-MigrationBatch, o fuso horário predefinido para o lote de migração é UTC. As propriedades CompleteAfter e CompleteAfterUTC contêm o mesmo valor (e também as propriedades StartAfter e StartAfterUTC). Quando cria o lote de migração no Centro de administração do Exchange (EAC), o fuso horário utilizado baseia-se 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
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, utiliza o parâmetro DiagnosticInfo apenas a pedido do Suporte e Suporte ao Cliente da Microsoft para resolver problemas. Os valores válidos são:
- attachmentid=Cadeia
- batch=Cadeia
- confirmar
- duration=String
- pontos de extremidade
- endtime=DateTime
- maxsize=Int32
- organization=String
- partition=String
- reportid=Cadeia
- relatórios
- showtimeline
- showtimeslots=Cadeia
- starttime=DateTime
- status=Cadeia
- armazenamento
- type=String
- user=String
- verboso
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.
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas 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
O comutador IncludeReport devolve 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.
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
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
- A concluir
- Danificado
- Criado
- Falhou
- IncrementalSyncing
- A remover
- Iniciando
- Parado
- A sincronizar
- A parar
- Sincronizados
- SyncedwithErrors
- A aguardar
Propriedades do parâmetro
| Tipo: | MMigrationBatchStatus |
| 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 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, 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.