Set-MigrationEndpoint
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 Set-MigrationEndpoint para editar definições para migrações faseadas ou de transferência do Exchange, migrações IMAP, migrações do Google Workspace (anteriormente 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 (Padrão)
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 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.
- Migração do Gmail: migrar dados da caixa de correio de um inquilino do Google Workspace para Exchange Online. Para uma migração do Google Workspace, primeiro tem de criar as caixas de correio ou os utilizadores de correio baseados na nuvem antes de migrar os dados da caixa de correio. As migrações do Google Workspace requerem a utilização de um ponto final do Gmail.
- 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:
- A caixa de correio é movida no Exchange Server
- Gerir movimentações de caixas de correio no local no Exchange Server
As alterações efetuadas a um ponto final que afete os utilizadores individuais no lote são aplicadas a partir da próxima vez que o lote for processado. Se estiver a executar este cmdlet no serviço baseado na cloud e quiser acelerar a aplicação destas definiçõ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, 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
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
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Fill AcceptUntrustedCertificates Description }}
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
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Fill ApplicationId Description }}
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
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Fill AppSecretKeyVaultUrl Description }}
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
Aplicável: Exchange Online
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 utilizado pelo servidor de correio 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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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, 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 confirmar 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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro Credenciais especifica o nome de utilizador e a palavra-passe para ligar ao ponto final remoto. As credenciais devem ser utilizadas ao criar um ponto final do Exchange faseado ou de transferência ou um ponto final 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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro ExchangeServer especifica o servidor Exchange de origem no local para migrações faseados e de transferência. Este parâmetro é aplicável apenas a pontos finais do Exchange faseados e de transferência que não utilizam a Deteção 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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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
Aplicável: Exchange Online
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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro MaxConcurrentMigrations especifica o número máximo de caixas de correio migradas para este ponto final num momento 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
Aplicável: Exchange Online
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. Este parâmetro só é aplicável a pontos finais do Exchange faseados e de transferência que não utilizem a Deteção 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
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 |
-Port
Aplicável: Exchange Online
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
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: | 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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro RemoteServer especifica o servidor remoto consoante o tipo de protocolo para movimentações:
- Movimentação do servidor Exchange: o FQDN de um servidor Exchange que tem a função de Acesso de Cliente instalada, uma matriz de servidor de Acesso de Cliente ou um grupo de servidores de Acesso de Cliente que estão localizados atrás de um balanceador de carga de rede suportado.
- IMAP move-se: 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
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
Para uma migração faseada do Exchange, o parâmetro RpcProxyServer especifica o FQDN do servidor proxy RPC para o servidor Exchange no local. Este parâmetro só é aplicável a pontos finais do Exchange faseados e de transferência que não utilizem a Deteção 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
Aplicável: Exchange Online
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 encriptação utilizado pelo servidor de correio remoto. As opções são Nenhum, 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
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro ServiceAccountKeyFileData é utilizado para especificar as informações necessárias para autenticar como uma conta de serviço. Os dados devem ser provenientes do ficheiro de chave JSON que é transferido quando a conta de serviço à qual é concedido acesso ao inquilino remoto é criada.
Um valor válido para este parâmetro requer que leia o ficheiro para um objeto codificado por bytes com a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Pode utilizar este comando como o valor do parâmetro ou escrever a saída numa variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e utilizar 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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O comutador SkipVerification ignora a verificação de que o servidor remoto está acessível ao criar um ponto final 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
Aplicável: Exchange Online
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
Aplicável: Exchange Online
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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
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 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.