Set-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 ou outro ambiente.
Use o cmdlet Set-MigrationEndpoint para editar configurações para migrações do Exchange, migrações de IMAP, migrações do Google Workspace (anteriormente G Suite) e movimentos remotos.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
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:
- Movimento entre florestas: mover caixas de correio entre duas florestas locais diferentes do Exchange. As movimentações entre florestas requerem o uso de um ponto de extremidade RemoteMove.
- Movimento remoto: em uma implantação híbrida, um movimento remoto envolve integração ou integração de migrações. 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 Exchange Online e usa um ponto de extremidade RemoteMove como ponto de extremidade de origem do lote de migração. O offboard move caixas de correio de Exchange Online para uma organização local do Exchange e usa um ponto de extremidade RemoteMove como ponto de extremidade de destino do lote de migração.
- Migração do Exchange de recorte: migre todas as caixas de correio em uma organização local do Exchange para Exchange Online. A migração do Exchange de recorte requer o uso de um ponto de extremidade do Exchange.
- Migração do Exchange em etapas: migre um subconjunto de caixas de correio de uma organização local do Exchange para Exchange Online. A migração do Exchange em etapas requer o uso de um ponto de extremidade do Exchange.
- Migração IMAP: migrar dados de caixa de correio de uma organização local do Exchange ou de outro sistema de email 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.
- Migração do Gmail: migrar dados da caixa de correio de um locatário do Google Workspace para Exchange Online. Para uma migração do Google Workspace, primeiro você deve criar os usuários de email ou caixas de correio baseados em nuvem antes de migrar dados da caixa de correio. As migrações do Google Workspace exigem o uso de um ponto de extremidade do Gmail.
- Local: mover caixas de correio entre servidores ou bancos de dados diferentes em uma única floresta do Exchange 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:
- A caixa de correio se move em Exchange Server
- Gerenciar movimentos de caixa de correio locais no Exchange Server
Alterações feitas em um ponto de extremidade que afetam os usuários individuais no 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 desejar acelerar o aplicativo 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 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
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.
{{ Preencher AcceptUntrustedCertificates Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ApplicationId
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Preencher ApplicationId Description }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-AppSecretKeyVaultUrl
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Preencher AppSecretKeyVaultUrl Description }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Authentication
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro autenticação especifica o método de autenticação usado pelo servidor de email remoto.
Type: | AuthenticationMethod |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Confirm
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false
. - A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.
Type: | SwitchParameter |
Aliases: | cf |
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 |
-Credentials
O parâmetro Credenciais especifica o nome de usuário e a senha para se conectar ao ponto de extremidade remoto. As credenciais devem ser usadas ao criar um ponto de extremidade do Exchange encenado ou de recorte 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.
Type: | PSCredential |
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 |
-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 de recorte e de etapas. Esse parâmetro é aplicável somente a pontos de extremidade do Exchange em etapas e de recorte que não usam a descoberta automática.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Identity
O parâmetro Identity especifica o nome do ponto de extremidade de migração que você deseja configurar.
Type: | MigrationEndpointIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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.
Type: | MigrationMailboxPermission |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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.
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 |
-MaxConcurrentMigrations
O parâmetro MaxConcurrentMigrations especifica o número máximo de caixas de correio que serão migradas para este ponto de extremidade, em um horário especificado. Este parâmetro é aplicável para todos os tipos de migração.
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 |
-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 encenados e de recorte que não usam a descoberta automática.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 |
-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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PublicFolderDatabaseServerLegacyDN
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-RemoteServer
O parâmetro RemoteServer especifica o servidor remoto dependendo do tipo de protocolo para movimentações:
- Movimentação do servidor exchange: o FQDN de um servidor exchange que tem a função de Acesso ao Cliente instalada, uma matriz de servidor de Acesso ao Cliente ou um grupo de servidores de Acesso ao Cliente que estão localizados atrás de um balanceador de carga de rede com suporte.
- Movimentos IMAP: O FQDN do servidor IMAP.
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, Exchange Online |
-RpcProxyServer
Esse parâmetro só está disponível no serviço baseado em nuvem.
Para uma migração do Exchange em etapas, 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 encenados e de recorte que não usam a descoberta automática
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Security
Esse parâmetro só está disponível no serviço baseado em nuvem.
Para uma migração IMAP, o parâmetro Segurança especifica o método de criptografia usado pelo servidor de email remoto. As opções são None, Tls ou Ssl.
Type: | IMAPSecurityMechanism |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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 se autenticar como uma conta de serviço. Os dados devem vir do arquivo de chave JSON que é baixado quando a conta de serviço que recebeu 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 bytes usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))
. Você pode usar esse comando como o valor do parâmetro ou 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
).
Type: | Byte[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SkipVerification
A opção SkipVerification ignora verificar se o servidor remoto é acessível ao criar um ponto de extremidade de migração. Não é preciso especificar um valor com essa opção.
Type: | SwitchParameter |
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 |
-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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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.
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-WhatIf
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Type: | SwitchParameter |
Aliases: | wi |
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.