Compartilhar via

Test-MigrationServerAvailability

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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 Test-MigrationServerAvailability para testar a disponibilidade do servidor de destino em preparação para executar movimentos de caixa de correio entre florestas, migração de caixas de correio locais para Exchange Online ou migrar dados da caixa de correio local de um servidor IMAP para Exchange Online caixas de correio. Para todos os tipos de migração, o cmdlet tenta verificar as configurações de conexão usadas para se conectar ao servidor de destino.

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

Syntax

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Confirm]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-Partition <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-FilePath <String>]
    [-PSTImport]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -ExchangeServer <String>
    -RPCProxyServer <Fqdn>
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-EmailAddress <SmtpAddress>]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-TestMailbox <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolder]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    [-Credentials <PSCredential>]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Endpoint <MigrationEndpointIdParameter>
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    -Port <Int32>
    [-Imap]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-Security <NIMAPSecurityMechanism]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -ServiceAccountKeyFileData <Byte[]>
    [-Gmail]
    [-EmailAddress <SmtpAddress>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Compliance]
    [-RemoteServer <Fqdn>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolderToUnifiedGroup]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolderToUnifiedGroup]
    [-Authentication <AuthenticationMethod>]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolder]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Description

O cmdlet Test-MigrationServerAvailability verifica se você pode se comunicar com o servidor de email local que abriga os dados da caixa de correio que você deseja migrar para caixas de correio baseadas em nuvem. Ao executar esse cmdlet, você deve especificar o tipo de migração. Você pode especificar se deve se comunicar com um servidor IMAP ou com um servidor exchange.

Para uma migração IMAP, esse cmdlet usa o FQDN (nome de domínio totalmente qualificado) do servidor e um número de porta para verificar a conexão. Se a verificação for bem-sucedida, use as mesmas configurações de conexão ao criar uma solicitação de migração com o cmdlet New-MigrationBatch.

Para uma migração do Exchange, este cmdlet usa uma das seguintes configurações para se comunicar com o servidor local:

  • Para o Exchange 2003, ele usa o FQDN do servidor e credenciais para uma conta de administrador que pode acessar o servidor.
  • Para versões Exchange Server 2007 e posteriores, você pode se conectar usando o serviço Autodiscover e o endereço de email de uma conta de administrador que pode acessar o servidor.

Se a verificação for bem-sucedida, você poderá usar as mesmas configurações para criar um ponto de extremidade de migração. Para saber mais, confira:

  • New-MigrationEndpoint
  • New-MigrationBatch

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

Test-MigrationServerAvailability -Imap -RemoteServer imap.contoso.com -Port 143

Para migrações IMAP, este exemplo verifica a conexão com o servidor de email IMAP imap.contoso.com.

Exemplo 2

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

Este exemplo usa os parâmetros Autodiscover e ExchangeOutlookAnywhere para verificar a conexão com um servidor exchange local em preparação para migrar caixas de correio locais para Exchange Online. Você pode usar um exemplo semelhante para testar as configurações de conexão para uma migração do Exchange em fases ou uma migração do Exchange de recorte.

Exemplo 3

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -ExchangeServer exch2k3.contoso.com -Credentials $Credentials -RPCProxyServer mail.contoso.com -Authentication NTLM

Este exemplo verifica a conexão com um servidor que executa Microsoft Exchange Server 2003 chamado exch2k3.contoso.com e usa o NTLM para o método de autenticação.

Exemplo 4

Test-MigrationServerAvailability -Endpoint endpoint.contoso.com

Este exemplo verifica as configurações de conexão para um servidor remoto usando as configurações armazenadas em um ponto de extremidade de migração existente no Exchange Online.

Exemplo 5

$MRSEndpoints = (Get-MigrationEndpoint).Identity

Foreach ($MEP in $MRSEndpoints) {Test-MigrationServerAvailability -Endpoint $MEP}

Este exemplo testa vários pontos de extremidade existentes.

Parâmetros

-AcceptUntrustedCertificates

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

{{ Preencher AcceptUntrustedCertificates Description }}

Type:SwitchParameter
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 Authentication especifica o método de autenticação usado pelo servidor de email no local. Use Basic ou NTLM. Se esse parâmetro não for incluído, o método de autenticação Basic é usado.

O parâmetro é usado apenas para migrações do Exchange de recorte e migrações de Exchange em etapas.

Type:AuthenticationMethod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Autodiscover

A opção Autodiscover especifica que o comando deve usar o serviço Autodiscover para obter as configurações de conexão para o servidor de destino. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Compliance

A opção Conformidade especifica que o tipo de ponto de extremidade é conformidade. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, 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 de uma conta que pode acessar caixas de correio no servidor de destino. Especifique o nome de usuário no formato domain\username ou o formato UPN (nome de entidade de usuário) (user@example.com).

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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-EmailAddress

O EmailAddress especifica o endereço de email de uma conta de administrador que pode acessar o servidor remoto. Esse parâmetro é necessário quando você usa o parâmetro Autodiscover.

Type:SmtpAddress
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Endpoint

O parâmetro Ponto de Extremidade especifica o nome do ponto de extremidade de migração ao qual se conectar. Um ponto de extremidade de migração contém as configurações de conexão e outras configurações de configuração de migração. Se você incluir esse parâmetro, o cmdlet Test-MigrationServerAvailability tentará verificar a capacidade de se conectar ao servidor remoto usando as configurações no ponto de extremidade de migração.

Type:MigrationEndpointIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExchangeOutlookAnywhere

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

A opção ExchangeOutlookAnywhere especifica um tipo de migração para migrar caixas de correio locais para Exchange Online. Não é preciso especificar um valor com essa opção.

Use essa opção se você planeja migrar caixas de correio para Exchange Online usando uma migração do Exchange em etapas ou uma migração do Exchange de recorte.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExchangeRemoteMove

A opção ExchangeRemoteMove especifica um tipo de migração em que as caixas de correio são movidas com total fidelidade entre duas florestas locais ou entre uma floresta local e Exchange Online. Não é preciso especificar um valor com essa opção.

Use essa opção se você planeja executar um movimento entre florestas ou migrar caixas de correio entre uma organização local do Exchange e Exchange Online em uma implantação híbrida.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExchangeServer

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

O parâmetro ExchangeServer especifica o FQDN do servidor do Exchange local. Use esse parâmetro quando planeja executar uma migração do Exchange em etapas ou uma migração de corte do Exchange. Esse parâmetro será necessário se você não usar o parâmetro Autodiscover.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-FilePath

O parâmetro FilePath especifica o caminho que contém os arquivos PST ao testar um ponto de extremidade de migração de importação PST.

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

-Gmail

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

O parâmetro do Gmail especifica o Gmail como o tipo de migração. Não é preciso especificar um valor com essa opção.

Essa opção é necessária quando você deseja migrar dados de um locatário do Google Workspace (antigo G Suite) para Exchange Online caixas de correio.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Imap

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

O parâmetro Imap especifica um tipo de migração IMAP. Não é preciso especificar um valor com essa opção.

Essa opção é necessária quando você deseja migrar dados de um servidor de email IMAP para Exchange Online caixas de correio.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MailboxPermission

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

O parâmetro MailboxPermission especifica quais permissões são atribuídas à conta de administrador de migração definida pelo parâmetro Credenciais. Você faz a atribuição de permissões para testar a conectividade com uma caixa de correio do usuário no servidor de email de origem quando estiver testando as configurações de conexão em preparação para uma migração do Exchange encenada ou de corte ou para criar um ponto de extremidade de migração do Exchange Outlook Anywhere.

Especifique um dos seguintes valores para a conta definida pelo parâmetro Credenciais:

  • FullAccess: a conta recebeu a permissão Full-Access para as caixas de correio que serão migradas.
  • Administração: a conta é membro do grupo Administradores de Domínio na organização que hospeda as caixas de correio que serão migradas.

Esse parâmetro não é usado para testar a conexão com o servidor remoto para uma migração de movimento remoto ou uma migração IMAP.

Type:MigrationMailboxPermission
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.

O parâmetro Port especifica o número da porta TCP usado pelo processo de migração do IMAP para se conectar ao servidor de destino. Esse parâmetro é necessário apenas para migrações IMAP.

O padrão é usar a porta 143 para conexões não criptografadas, a porta 143 para TLS (Transport Layer Security) e a porta 993 para SSL (Secure Sockets Layer).

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PSTImport

Este parâmetro está disponível somente no Exchange local.

Esse parâmetro está reservado para uso interno da Microsoft.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-PublicFolder

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

Esse parâmetro está reservado para uso interno da Microsoft.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PublicFolderToUnifiedGroup

O comutador PublicFolderToUnifiedGroup especifica que o tipo de ponto de extremidade é pastas públicas para Grupos do Microsoft 365. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-RemoteServer

O parâmetro RemoteServer especifica o FQDN do servidor de email local. Esse parâmetro é necessário quando você deseja executar um dos seguintes tipos de migração:

  • Movimentação entre florestas
  • Movimentação remota (implantações híbridas)
  • Migração do IMAP
Type:Fqdn
Position:Named
Default value:None
Required:True
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.

O parâmetro RPCProxyServer especifica o FQDN do servidor proxy RPC para o servidor do Exchange local. Esse parâmetro é necessário quando você não usa o parâmetro Autodiscover. Use esse parâmetro se você planeja executar uma migração do Exchange em etapas ou uma migração de transferência do Exchange para migrar caixas de correio para Exchange Online.

Type:Fqdn
Position:Named
Default value:None
Required:True
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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 tentará acessar essa caixa de correio usando as credenciais da conta de administrador no servidor de destino.

Type:String
Position:Named
Default value:None
Required:True
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 tentará acessar essa caixa de correio usando as credenciais da 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.