Partilhar via

Get-MigrationEndpoint

Módulo:
Exchange PowerShell

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.

Utilize o cmdlet Get-MigrationEndpoint para obter as definições de ponto final de migração para servidores de origem ou destino para migrações de transferência ou faseadas do Exchange, 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 do Exchange no local diferentes. As movimentações entre florestas requerem o uso de um ponto de extremidade RemoteMove.
  • Movimentação remota: numa implementação híbrida, uma movimentação remota envolve migrações de inclusão ou exclusão. As movimentações remotas requerem o uso de um ponto de extremidade RemoteMove. A inclusão move caixas de correio de uma organização do Exchange no local para Exchange Online e utiliza um ponto final RemoteMove como o ponto final de origem do lote de migração. A exclusão move caixas de correio de Exchange Online para uma organização do Exchange no local e utiliza um ponto final RemoteMove como o ponto final de destino do lote de migração.
  • Migração do Exchange de Transferência: migre todas as caixas de correio numa organização do Exchange no local para Exchange Online. A migração de Transferência do Exchange requer a utilização de um ponto final do Exchange.
  • Migração faseada do Exchange: migre um subconjunto de caixas de correio de uma organização do Exchange no local para Exchange Online. A migração faseada do Exchange requer a utilização de um ponto final do Exchange.
  • Migração IMAP: migre os dados da caixa de correio de uma organização do Exchange no local ou de outro sistema de e-mail para 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 bases de dados numa única floresta do Exchange no local. 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, 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.

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

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

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: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: Transferência ou migrações faseados do Exchange
  • ExchangeRemoteMove: Movimentações e migrações remotas
  • IMAP: migrações IMAP
  • PublicFolder: Migrações de pastas públicas

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