Get-MigrationUser

Módulo:
Exchange PowerShell

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

Sintaxe

MailboxGuid 

Get-MigrationUser
    -MailboxGuid <Guid>
    [-DomainController <Fqdn>]
    [-IncludeAssociatedUsers]
    [-ResultSize <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [<CommonParameters>]

StatusAndBatchId 

Get-MigrationUser
    [-BatchId <MigrationBatchIdParameter>]
    [-Status <MigrationUserStatus>]
    [-StatusSummary <MigrationUserStatusSummary>]
    [-DomainController <Fqdn>]
    [-IncludeAssociatedUsers]
    [-ResultSize <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [<CommonParameters>]

Identity 

Get-MigrationUser
    [[-Identity] <MigrationUserIdParameter>]
    [-DomainController <Fqdn>]
    [-IncludeAssociatedUsers]
    [-ResultSize <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [<CommonParameters>]

EmailAddress 

Get-MigrationUser
    -EmailAddress <SmtpAddress>
    [-DomainController <Fqdn>]
    [-IncludeAssociatedUsers]
    [-ResultSize <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [<CommonParameters>]

Description

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.

Exemplos

Exemplo 1

Get-MigrationUser -Identity TonySmith@contoso.com

Este exemplo recupera informações de status sobre o usuário migrado recentemente, 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 em andamento para o usuário com o GUID de caixa de correio especificado.

Exemplo 3

Get-MigrationUser -EmailAddress TonySmith@contoso.com

Este exemplo recupera informações de status sobre o usuário migrado recentemente, Tony Smith.

Exemplo 4

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

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

Parâmetros

-BatchId

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propriedades do parâmetro

Tipo:MigrationBatchIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

StatusAndBatchId
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

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EmailAddress

Aplicável: Exchange Online

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.

Propriedades do parâmetro

Tipo:EmailAddress
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EmailAddress
Cargo:Named
Obrigatório:True
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 especifica a migração em andamento específica sobre a qual você deseja recuperar informações. O parâmetro Identity geralmente é representado como um endereço de email.

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

-IncludeAssociatedUsers

Aplicável: Exchange Online

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

{{ Fill IncludeAssociatedUsers Description }}

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

-MailboxGuid

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

MailboxGuid
Cargo:Named
Obrigatório:True
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

(All)
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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

(All)
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 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
  • Concluindo
  • CompletionFailed
  • CompletionSynced
  • Corrompidos
  • Falhou
  • IncrementalFailed
  • IncrementalStopped
  • IncrementalSynced
  • IncrementalSyncing
  • Provisionamento
  • ProvisionUpdating
  • Na fila
  • Removendo
  • Iniciando
  • Parado
  • Parando
  • Sincronizados
  • Sincronização
  • Validando

Propriedades do parâmetro

Tipo:MigrationUserStatus
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

StatusAndBatchId
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StatusSummary

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propriedades do parâmetro

Tipo:MigrationUserStatusSummary
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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