Set-MigrationEndpoint

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 Set-MigrationEndpoint para editar as configurações de migrações de substituição ou em estágios do Exchange, migrações IMAP, migrações do Google Workspace (antigo G Suite) e movimentações remotas.

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

Sintaxe

Default (Default)

Set-MigrationEndpoint
    [-Identity] <MigrationEndpointIdParameter>
    [-AcceptUntrustedCertificates <Boolean>]
    [-ApplicationId <String>]
    [-AppSecretKeyVaultUrl <String>]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-Credentials <PSCredential>]
    [-DomainController <Fqdn>]
    [-ExchangeServer <String>]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-MaxConcurrentIncrementalSyncs <Unlimited>]
    [-MaxConcurrentMigrations <Unlimited>]
    [-NspiServer <String>]
    [-Partition <MailboxIdParameter>]
    [-Port <Int32>]
    [-PublicFolderDatabaseServerLegacyDN <String>]
    [-RemoteServer <Fqdn>]
    [-RpcProxyServer <Fqdn>]
    [-Security <IMAPSecurityMechanism>]
    [-ServiceAccountKeyFileData <Byte[]>]
    [-SkipVerification]
    [-SourceMailboxLegacyDN <String>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Description

Use o cmdlet Set-MigrationEndpoint para definir as configurações para tipos diferentes 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.
Migração do Gmail: migre dados de caixa de correio de um locatário do Google Workspace para o Exchange Online. Para uma migração do Google Workspace, você deve primeiro criar os usuários de e-mail ou caixas de correio baseados na nuvem antes de migrar os dados da caixa de correio. As migrações do Google Workspace exigem o uso de um endpoint do Gmail.
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:

As alterações feitas em um ponto de extremidade que afetam os usuários individuais dentro do lote são aplicadas a partir da próxima vez que o lote for processado. Se você estiver executando esse cmdlet no serviço baseado em nuvem e quiser acelerar a aplicação dessas configurações, considere executar o cmdlet Set-MigrationBatch com o parâmetro -Update.

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

Set-MigrationEndpoint -Identity CutoverExchangeEndpoint01 -MaxConcurrentIncrementalSyncs 50 -NspiServer Server01.contoso.com

Este exemplo altera a configuração do MaxConcurrentIncrementalSyncs para 50, no ponto de extremidade de migração CutoverExchangeEndpoint01 usando o servidor de NSPI Server01.

Exemplo 2

Set-MigrationEndpoint -Identity Onboardingmigrationendpoint01 -MaxConcurrentMigrations 10 -RemoteServer Server01.contoso.com

Este exemplo altera a configuração do MaxConcurrentMigrations para 10, no ponto de extremidade de migração Onboardingmigrationendpoint01 usando o servidor remoto Server01.

Parâmetros

-AcceptUntrustedCertificates

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

O parâmetro AcceptUntrustedCertificates especifica se os certificados não confiáveis devem ser aceitos do servidor remoto. Os valores válidos são $true ou $false. Esse parâmetro é aplicável aos pontos de extremidade de migração IMAP e ExchangeOutlookAnywhere.

Propriedades do parâmetro

Tipo:	Boolean
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

-ApplicationId

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

O parâmetro ApplicationId especifica a ID do aplicativo do aplicativo registrado no Microsoft Entra ID que é usado para autenticação entre locatários nos pontos de extremidade de migração ExchangeRemoteMove. Use esse parâmetro junto com AppSecretKeyVaultUrl.

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

-AppSecretKeyVaultUrl

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

O parâmetro AppSecretKeyVaultUrl especifica a URL Azure Key Vault que contém o segredo do aplicativo usado para autenticação entre locatários nos pontos de extremidade de migração do ExchangeRemoteMove. Use esse parâmetro junto com ApplicationId.

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

-Authentication

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

O parâmetro Authentication especifica o método de autenticação usado pelo servidor de email remoto.

Propriedades do parâmetro

Tipo:	AuthenticationMethod
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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	cf

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

-Credentials

O parâmetro Credentials especifica o nome de usuário e a senha para se conectar ao ponto de extremidade remoto. As credenciais devem ser usadas ao modificar um ponto de extremidade do Exchange em estágios ou de substituição ou um ponto de extremidade RemoteMove.

Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.

Propriedades do parâmetro

Tipo:	PSCredential
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

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

-ExchangeServer

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

O parâmetro ExchangeServer especifica o servidor Exchange de origem local para migrações em estágios e de substituição. Esse parâmetro é aplicável somente a pontos de extremidade do Exchange em estágios e de substituição que não usam a Descoberta Automática.

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

-Identity

O parâmetro Identity especifica o nome do ponto de extremidade de migração que você deseja configurar.

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)

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

-MailboxPermission

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

O parâmetro MailboxPermission especifica quais permissões devem ser usadas para acessar a caixa de correio de origem durante o processo de admissão do do Outlook em Qualquer Lugar (migração de transferência do Exchange e migração em estágios do Exchange). Esse parâmetro não é para migrações que não sejam do OutlookAnywhere.

A conta especificada deve ter as seguintes permissões:

Permissão de FullAccess. A conta tem permissão de Acesso Completo às caixas de correio que desejam migrar.
Permissão de administrador. A conta é um administrador de domínio que pode acessar qualquer caixa de correio que desejam migrar.

Propriedades do parâmetro

Tipo:	MigrationMailboxPermission
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

-MaxConcurrentIncrementalSyncs

O parâmetro MaxConcurrentIncrementalSyncs especifica o número total máximo de sincronizações incrementais permitidas para este ponto de extremidade, em um determinado momento. Este valor deve ser menor ou igual ao parâmetro MaxConcurrentMigrations.

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

-MaxConcurrentMigrations

O parâmetro MaxConcurrentMigrations especifica o número máximo de caixas de correio migradas para esse ponto de extremidade em um horário especificado. Este parâmetro é aplicável para todos os tipos de migração.

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

-NspiServer

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

O parâmetro NspiServer especifica o FQDN do servidor do NSPI (Interface de Provedor de Serviço de Nome) remoto. Esse parâmetro só é aplicável a pontos de extremidade do Exchange em estágios e de substituição que não usam a Descoberta Automática.

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

-Partition

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

-Port

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

Para uma migração IMAP, o parâmetro Port especifica o número da porta TCP usado pelo processo de migração para se conectar ao servidor remoto.

Propriedades do parâmetro

Tipo:	Int32
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

-PublicFolderDatabaseServerLegacyDN

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

-RemoteServer

O parâmetro RemoteServer especifica o servidor remoto, dependendo do tipo de protocolo para movimentações:

Movimentações do servidor Exchange: o FQDN de um servidor Exchange que tem a função de Acesso para Cliente instalada, uma matriz de servidor de Acesso para Cliente ou um grupo de servidores de Acesso para Cliente que estão localizados atrás de um balanceador de carga de rede compatível.
Movimentos IMAP: O FQDN do servidor IMAP.

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

-RpcProxyServer

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

Para migrações do Exchange em estágios e substituição, o parâmetro RpcProxyServer especifica o FQDN do servidor proxy RPC para o servidor Exchange local. Esse parâmetro só é aplicável a pontos de extremidade do Exchange em estágios e de substituição que não usam a Descoberta Automática

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

-Security

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

Para uma migração IMAP, o parâmetro Security especifica o método de criptografia usado pelo servidor de email remoto. As opções são None, Tls ou Ssl.

Propriedades do parâmetro

Tipo:	IMAPSecurityMechanism
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

-ServiceAccountKeyFileData

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

O parâmetro ServiceAccountKeyFileData é usado para especificar as informações necessárias para autenticar como uma conta de serviço. Os dados devem vir do arquivo de chave JSON baixado quando a conta de serviço que recebe acesso ao locatário remoto é criada.

Um valor válido para esse parâmetro exige que você leia o arquivo em um objeto codificado por byte usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Você pode usar esse comando como o valor do parâmetro ou pode gravar a saída em uma variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usar a variável como o valor do parâmetro ($data).

Propriedades do parâmetro

Tipo:	Byte[]
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

-SkipVerification

O comutador SkipVerification ignora a verificação de que o servidor remoto está acessível ao modificar um ponto de extremidade de migração. Não é preciso especificar um valor com essa opção.

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

-SourceMailboxLegacyDN

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

O parâmetro SourceMailboxLegacyDN especifica uma caixa de correio no servidor de destino. Use o LegacyExchangeDN para a caixa de correio de teste local, como o valor para esse parâmetro. O cmdlet tenta acessar essa caixa de correio usando as credenciais para a conta de administrador no servidor de destino.

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

-TestMailbox

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

O parâmetro TestMailbox especifica a caixa de correio no servidor de destino. Use o endereço SMTP principal como o valor desse parâmetro. O cmdlet tenta acessar essa caixa de correio usando as credenciais para a conta de administrador no servidor de destino.

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

-WhatIf

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	wi

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

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.

Comentários

Esta página foi útil?