Get-MigrationUser

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-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.