Get-MigrationEndpoint

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-MigrationEndpoint para recuperar configurações de ponto de extremidade de migração para servidores de origem ou de destino para migrações do Exchange em estágios ou de substituição, migrações IMAP e movimentações remotas.

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

Sintaxe

ConnectionSettingsFilter

Get-MigrationEndpoint
    -ConnectionSettings <ExchangeConnectionSettings>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

TypeFilter

Get-MigrationEndpoint
    -Type <MigrationType>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-Partition <MailboxIdParameter>]
    [-DiagnosticInfo <String>]
    [<CommonParameters>]

Identity

Get-MigrationEndpoint
    [[-Identity] <MigrationEndpointIdParameter>]
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-Partition <MailboxIdParameter>]
    [-DiagnosticInfo <String>]
    [<CommonParameters>]

Description

O cmdlet Get-MigrationEndpoint recupera as configurações para diferentes tipos de migração:

  • Movimentação entre florestas: mova caixas de correio entre duas florestas locais diferentes do Exchange. As movimentações entre florestas requerem o uso de um ponto de extremidade RemoteMove.
  • Movimentação remota: em uma implantação híbrida, uma movimentação remota envolve migrações de integração ou desligamento. As movimentações remotas requerem o uso de um ponto de extremidade RemoteMove. A integração move caixas de correio de uma organização local do Exchange para o Exchange Online e usa um ponto de extremidade RemoteMove como o ponto de extremidade de origem do lote de migração. O desligamento move caixas de correio do Exchange Online para uma organização local do Exchange e usa um ponto de extremidade RemoteMove como o ponto de extremidade de destino do lote de migração.
  • Migração de substituição do Exchange: migre todas as caixas de correio em uma organização local do Exchange para o Exchange Online. Substituição A migração do Exchange requer o uso de um ponto de extremidade do Exchange.
  • Migração do Exchange em estágios: migre um subconjunto de caixas de correio de uma organização local do Exchange para o Exchange Online. A migração do Exchange em estágios requer o uso de um ponto de extremidade do Exchange.
  • Migração IMAP: migre dados de caixa de correio de uma organização local do Exchange ou outro sistema de email para o Exchange Online. Para uma migração IMAP, você deve primeiro criar as caixas de correio baseadas em nuvem antes de migrar os dados da caixa de correio. As migrações IMAP requerem o uso de um ponto de extremidade IMAP.
  • Local: Mova caixas de correio entre diferentes servidores ou bancos de dados em uma única floresta local do Exchange. As movimentações locais não requerem o uso de um ponto de extremidade.

Para mais informações sobre cenários diferentes de movimentação e migração, consulte:

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-MigrationEndpoint -Identity OnboardingME01

Este exemplo recupera as configurações para o ponto de extremidade de migração, OnboardingME01.

Parâmetros

-ConnectionSettings

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 ConnectionSettings especifica as configurações de servidores de origem ou de destino para que você deseja encontrar um ponto de extremidade correspondente.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-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

(All)
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

(All)
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

(All)
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

-Identity

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

O parâmetro Identity especifica o nome do ponto de extremidade de migração para o qual você deseja recuperar as definições.

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

-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

-Type

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

O parâmetro Type filtra os resultados por tipo de migração. O parâmetro PasswordQuality especifica a classificação mínima de qualidade da senha exigida para as senhas dos dispositivo. Qualidade de senha é uma escala numérica que indica a segurança e a complexidade da senha. Um valor de qualidade mais alto indica uma senha mais segura.

  • ExchangeOutlookAnywhere: migrações de substituição ou em estágios do Exchange
  • ExchangeRemoteMove: movimentações e migrações remotas
  • IMAP: Migrações IMAP
  • PublicFolder: Migrações de pasta pública

Propriedades do parâmetro

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

Conjuntos de parâmetros

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