Compartilhar via


Get-MigrationUser

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-MigrationUser para exibir informações sobre usuários de movimentação e migração.

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

Syntax

Get-MigrationUser
   -MailboxGuid <Guid>
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [-Partition <MailboxIdParameter>]
   [<CommonParameters>]
Get-MigrationUser
   [-BatchId <MigrationBatchIdParameter>]
   [-Status <MigrationUserStatus>]
   [-StatusSummary <MigrationUserStatusSummary>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [-Partition <MailboxIdParameter>]
   [<CommonParameters>]
Get-MigrationUser
   [[-Identity] <MigrationUserIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [-Partition <MailboxIdParameter>]
   [<CommonParameters>]
Get-MigrationUser
   -EmailAddress <SmtpAddress>
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [-Partition <MailboxIdParameter>]
   [<CommonParameters>]

Description

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.

Exemplos

Exemplo 1

Get-MigrationUser -Identity TonySmith@contoso.com

Este exemplo recupera informações de status sobre o usuário recém-migrado, Tony Smith.

Exemplo 2

Get-MigrationUser -MailboxGuid b6a6795c-a010-4f67-aaaa-da372d56fcb9 | Get-MigrationUserStatistics

Este exemplo recupera informações mais detalhadas sobre qualquer migração contínua para o usuário com a caixa de correio GUID especificada.

Exemplo 3

Get-MigrationUser -EmailAddress TonySmith@contoso.com

Este exemplo recupera informações de status sobre o usuário recém-migrado, Tony Smith.

Exemplo 4

Get-MigrationUser -EmailAddress TonySmith@contoso.com | Get-MigrationUserStatistics

Este exemplo recupera informações mais detalhadas sobre qualquer migração contínua para o usuário com o endereço de email especificado.

Parâmetros

-BatchId

O parâmetro BatchId especifica o nome do lote de migração para o qual você deseja retornar usuários.

Type:MigrationBatchIdParameter
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

-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

-EmailAddress

O parâmetro EmailAddress especifica o usuário específico sobre o qual você deseja recuperar informações. O parâmetro EmailAddress é representado como um endereço de email. Esse parâmetro só está disponível no serviço baseado em nuvem.

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

-Identity

O parâmetro Identity especifica a migração contínua específica sobre a qual você deseja recuperar informações. O parâmetro Identity geralmente é representado como um endereço de email.

Type:MigrationUserIdParameter
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

-MailboxGuid

O parâmetro MailboxGuid especifica o GUID de uma caixa de correio para a qual você deseja exibir as informações de migração.

Type:Guid
Position:Named
Default value:None
Required:True
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

-ResultSize

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.

Type:Unlimited
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

-Status

O parâmetro Status retorna informações sobre usuários de migração que têm o estado de status especificado. Use um dos valores a seguir:

  • Concluído
  • CompletedWithWarnings
  • Completar
  • Falha na conclusão
  • CompletionSynced
  • Corrompido
  • Falhou
  • Falha Incremental
  • IncrementalStopped
  • IncrementalSynced
  • IncrementalSyncing
  • Provisionamento
  • ProvisionamentoUpdating
  • Na fila
  • Remover
  • Iniciando
  • Parado
  • Parar
  • Sincronizados
  • Sincronizando
  • Validando
Type:MigrationUserStatus
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

-StatusSummary

O parâmetro StatusSummary retorna informações abreviadas sobre usuários de migração que têm o valor de status especificado. Use um dos valores a seguir:

  • Ativo
  • Concluído
  • Falhou
  • Parado
  • Sincronizados
Type:MigrationUserStatusSummary
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.