Test-OutlookConnectivity

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Test-OutlookConnectivity para testar a conectividade de cliente de ponta a ponta Microsoft Outlook na organização Microsoft Exchange. Isso inclui testes para o Outlook Anywhere (RPC por HTTP) e MAPI em conexões HTTP.

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

Syntax

Test-OutlookConnectivity
    [-ProbeIdentity] <String>
    [-Credential <PSCredential>]
    [-Hostname <String>]
    [-MailboxId <MailboxIdParameter>]
    [-RunFromServerId <ServerIdParameter>]
    [-TimeOutSeconds <String>]
    [<CommonParameters>]
Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -Protocol <Protocol>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]
Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -GetDefaultsFromAutodiscover <Boolean>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyServer <ServerIdParameter>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]
Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -RpcTestType <RpcTestType>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyTestType <RpcProxyTestType>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]
Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -WSTestType <VirtualDirectoryUriScope>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Description

Executar o cmdlet Test-OutlookConnectivity valida uma conexão do Outlook definida pelos parâmetros fornecidos. O comando é capaz de validar uma única caixa de correio.

O cmdlet Test-OutlookConnectivity executa o mesmo processo que as investigações de monitoramento. O serviço Microsoft Exchange Health Manager (MSExchangeHM) deve estar em execução e criou as investigações do Outlook no computador que serão testadas. Você precisa selecionar uma das identidades de investigação do Outlook para executar o teste. Use o cmdlet Get-MonitoringItemIdentity para ver quais investigações estão ativas.

Este exemplo lista as investigações em execução nos serviços de back-end em um servidor de caixa de correio: Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook.protocol | ?{$_.Name -like '*probe'}.

Este exemplo lista as investigações em execução nos serviços de acesso ao cliente em um servidor de caixa de correio: Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook | ?{$_.Name -like '*probe'}.

Para obter mais informações sobre investigações e a estrutura de monitoramento, consulte Disponibilidade Gerenciada, Disponibilidade Gerenciada e Integridade do Servidor e Personalização da Disponibilidade Gerenciada.

Por padrão, o cmdlet usa a conta de monitoramento de teste anexada à investigação especificada. Você pode inserir uma caixa de correio diferente com o parâmetro MailboxId. As opções e os resultados são indicados a seguir.

  • MailboxId e Credential não são especificados: teste de conectividade genérico em uma caixa de correio de teste usando as credenciais de teste do sistema.
  • MailboxId é especificado, Credencial não é: teste de conectividade com a caixa de correio específica usando as credenciais de teste do sistema.
  • MailboxId e Credential são especificados: você realiza um teste de conectividade para a caixa de correio específica e um teste de que as credenciais fornecidas são válidas para essa caixa de correio

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-OutlookConnectivity -ProbeIdentity OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe

No Exchange 2013 ou posterior, este exemplo executa um MAPI sobre HTTP OutlookRpcSelfTestProbe no servidor mailbox ao qual você está conectado no momento.

Exemplo 2

Test-OutlookConnectivity "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 1234512345" -RunFromServerId PrimaryMailbox -MailboxId johnd@contoso.com

No Exchange 2013 ou posterior, este exemplo executa o OutlookRpcDeepTestProbe do servidor "PrimaryMailbox" para a caixa de correio "johnd@contoso.com" montada em "Banco de Dados da Caixa de Correio 1234512345". Como o parâmetro Credential não é especificado, a investigação usará as credenciais de teste padrão.

Exemplo 3

Test-OutlookConnectivity -Protocol HTTP -GetDefaultsFromAutoDiscover $true

No Exchange 2010, este exemplo testa o cenário de conectividade de ponta a ponta mais comum do Outlook para Outlook Anywhere. Isso inclui o teste de conectividade por meio do serviço de Descoberta Automática, a criação de um perfil de usuário e o logon na caixa de correio do usuário. Todos os valores necessários são recuperados do serviço autodiscover. Como o parâmetro Identity não está especificado, o comando usa o usuário de teste temporário que você criou usando o script New-TestCasConnectivityUser.ps1. Este comando de exemplo pode ser executado para testar a conectividade TCP/IP definindo o parâmetro Protocolo como RPC.

Exemplo 4

Test-OutlookConnectivity -RpcProxyTestType:Internal -RpcTestType:Server

No Exchange 2010, este exemplo testa a conectividade do Outlook Anywhere usando o servidor local como o ponto de extremidade RpcProxy, bem como o ponto de extremidade RPC. Como o parâmetro Identity não está especificado, o comando usa o usuário de teste temporário que você criou usando o script New-TestCasConnectivityUser.ps1. Modifique este exemplo para usar a URL externa pública definindo o parâmetro RpcProxyTestType como Externo. Além disso, o comando de exemplo pode usar a matriz do servidor de Acesso ao Cliente como o ponto de extremidade RPC definindo o parâmetro RpcTestType como Array. Para validar apenas a conectividade TCP/IP, omita o parâmetro RpcProxyTestType.

Exemplo 5

Test-OutlookConnectivity -RpcProxyServer RpcProxySrv01 -RpcProxyAuthenticationType Basic -RpcClientAccessServer CAS01 -RpcAuthenticationType NTLM

No Exchange 2010, este exemplo valida a conectividade do Outlook por meio do RpcProxy em um servidor diferente que executa a função de servidor do Client Access com o Basic para a camada de autenticação externa e o NTLM para a camada de autenticação interna. O uso desses parâmetros deve permitir que você valide a maioria dos tipos de configurações de conectividade do Outlook. Esse comando também pode ser usado com o parâmetro GetDefaultsFromAutoDiscover definido como $true se você precisar substituir apenas um ou dois parâmetros. Este comando a seguir é semelhante à execução de um teste de conectividade usando o utilitário RPC Ping, mas fornece uma validação mais forte.

Parâmetros

-Archive

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro Arquivo especifica se os testes devem ser realizados para se conectar à caixa de correio de arquivo local do usuário. Os valores válidos são:

$true: conecte-se à caixa de correio de arquivo local do usuário.

$false: não se conecte à caixa de correio local do usuário. Esse é o valor padrão.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Confirm

Esse parâmetro só está disponível no Exchange Server 2010.

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 2010

-Credential

O parâmetro Credential especifica a credencial usada pela investigação. As credenciais de teste do sistema são usadas por padrão

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

-GetDefaultsFromAutodiscover

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro GetDefaultsFromAutodiscover especifica se deve obter valores padrão para todos os outros parâmetros para o comando das configurações de serviço de Autodiscover. Se você executar o comando especificando valores para outros parâmetros, esses valores substituirão os valores padrão do serviço autodiscover. O valor padrão desse parâmetro é $true.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Hostname

O parâmetroHostname especifica o destino do ponto de extremidade do protocolo da investigação. Você pode usar um servidor de caixa de correio específico ou rotear por meio do servidor do Serviço de Nome Distribuído.

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

-Identity

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro Identity especifica uma caixa de correio de usuário de destino. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Se você não usar esse parâmetro, o comando procurará um usuário de teste no Active Directory que você criou anteriormente usando o script New-TestCasConnectivityUser.ps1.

Type:MailboxIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MailboxCredential

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro MailboxCredential especifica determinadas credenciais para permitir o acesso de logon à caixa de correio de um usuário. Use o parâmetro junto com o parâmetro Identity para acessar a caixa de correio de um usuário quando você não tiver permissões de acesso.

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:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MailboxId

O parâmetro MailboxID especifica a caixa de correio de destino.

No Exchange 2013 ou posterior, o parâmetro Identity especifica uma caixa de correio de usuário de destino. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Se você não usar esse parâmetro, o comando usará a conta de teste.

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

-MonitoringContext

Esse parâmetro só está disponível no Exchange Server 2010.

A opção MonitoringContext inclui os eventos de monitoramento e os contadores de desempenho associados nos resultados. Não é preciso especificar um valor com essa opção.

Normalmente, você inclui os eventos de monitoramento e contadores de desempenho nos resultados quando a saída é passada para Microsoft SCOM (System Center Operations Manager).

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

-ProbeIdentity

O parâmetro ProbeIdentity especifica a investigação a ser usada. Os valores válidos são:

Investigações do Outlook Anywhere (RPC sobre HTTP):

  • Outlook.Protocol\OutlookRpcSelfTestProbe: valida que o ponto de extremidade RPC/HTTP é capaz de receber tráfego no servidor da caixa de correio. Ele não tenta fazer logon em uma caixa de correio. É uma verificação de conectividade de alto nível.
  • Outlook.Protocol\OutlookRpcDeepTestProbe: valida que o ponto de extremidade RPC/HTTP está funcionando no servidor da caixa de correio. Ele tentará se conectar e fazer logon na caixa de correio. Como nenhum banco de dados é especificado, ele tentará se conectar ao primeiro banco de dados retornado pelo cmdlet Get-MailboxDatabase.
  • Outlook.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: valida que o ponto de extremidade RPC/HTTP está funcionando no Servidor de Caixa de Correio. Ele tentará se conectar e fazer logon na caixa de correio no banco de dados de caixa de correio especificado. Se o nome do banco de dados da caixa de correio contiver espaços, inclua todo o valor entre aspas (por exemplo, "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530").

MAPI sobre investigações HTTP:

  • OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe: valida que o ponto de extremidade MAPI/HTTP é capaz de receber tráfego no servidor da caixa de correio. Ele não tenta fazer logon em uma caixa de correio. É uma verificação de conectividade de alto nível.
  • OutlookMapiHttp.Protocol\OutlookMapiHttpDeepTestProbe: valida que o ponto de extremidade MAPI/HTTP está funcionando no servidor da caixa de correio. Ele tentará se conectar e fazer logon na caixa de correio. Como nenhum banco de dados é especificado, ele tentará se conectar ao primeiro banco de dados retornado pelo cmdlet Get-MailboxDatabase.
  • OutlookMapiHttp.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: valida que o ponto de extremidade MAPI/HTTP está funcionando no Servidor de Caixa de Correio. Ele tentará se conectar e fazer logon na caixa de correio no banco de dados especificado. Se o nome do banco de dados da caixa de correio contiver espaços, inclua todo o valor entre aspas (por exemplo, "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530").
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Protocol

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro Protocolo especifica se é necessário testar a conectividade do Outlook Anywhere ou testar diretamente a conectividade RPC ou TCP/IP. O valor é HTTP ou TCP.

Type:Protocol
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcAuthenticationType

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro RpcAuthenticationType especifica a configuração de autenticação a ser testada para a camada RPC. Usar esse parâmetro será útil se um tipo de autenticação diferente for definido no diretório virtual proxy do RPC. É possível usar os seguintes valores:

  • NTLM
  • Kerberos
  • Negociar

O valor padrão é Negociar.

Type:RpcAuthenticationType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcClientAccessServer

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro RpcClientAccessServer especifica o servidor de destino com a função de servidor de Acesso ao Cliente instalada que você deseja testar. Isso pode ser um FQDN (nome de domínio totalmente qualificado) do servidor ou um GUID.

Type:ClientAccessServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcProxyAuthenticationType

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro RpcProxyAuthenticationType especifica a configuração de autenticação para o ponto de extremidade proxy do RPC. O valor pode ser especificado como Basic, NTLM ou Negotiate. Não há nenhum valor padrão a menos que seja usado com o parâmetro GetDefaultsFromAutodiscover.

Type:RPCProxyAuthenticationType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcProxyServer

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro RpcProxyServer especifica se o servidor RpcProxy de destino deve ser definido para teste. Esse parâmetro pode ser usado quando o servidor RpcProxy é diferente do servidor de Acesso ao Cliente.

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcProxyTestType

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro RpcProxyTestType especifica a qual ponto de extremidade HTTP o comando deve se conectar. Os valores válidos são:

  • Interno: refere-se ao nome do computador local (https://<localcomputername>por exemplo, https://CAS01).
  • Externo: refere-se a um namespace público (a URL HTTP externa no diretório virtual /rpc, por exemplo, https://mail.contoso.com).
Type:RpcProxyTestType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcTestType

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro RpcTestType especifica qual tipo de ponto de extremidade RPC o comando deve testar. Os valores válidos são:

  • Servidor: o comando usa o servidor local como o ponto de extremidade RPC.
  • Matriz: o comando procura um objeto ClientAccessArray no site do Active Directory local.
Type:RpcTestType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RunFromServerId

O parâmetro RunFromServerID especifica o servidor no qual a investigação deve ser executada.

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

-TimeOutSeconds

O parâmetro TimeOutSeconds especifica o período de tempo limite, em segundos, antes que a investigação seja encerrada. O valor padrão é 30 segundos. Os dígitos podem ser inseridos com ou sem o uso de aspas. 10 ou "10" funcionarão. Qualquer erro de entrada irá redefinir para o padrão de 30 segundos.

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

-TotalTimeoutInMinutes

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro TotalTimeoutInMinutes especifica o limite de tempo, em minutos, para que o comando aguarde os resultados do teste antes de encerrar a solicitação. O valor padrão é de dois minutos.

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

-TrustAnySslCert

Esse parâmetro só está disponível no Exchange Server 2010.

A opção TrustAnySSSLCertificate permite que o Exchange aceite certificados de CAs (autoridades de certificação não confiáveis). Não é preciso especificar um valor com essa opção.

A opção TrustAnySSLCertificate especifica se as falhas de validação do certificado SSL (Secure Sockets Layer) serão ignoradas. 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 2010

-WhatIf

Esse parâmetro só está disponível no Exchange Server 2010.

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 2010

-WSTestType

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro WSTestType especifica o tipo de servidores que você deseja incluir no teste de conectividade do Outlook. É possível usar os seguintes valores:

  • Desconhecido (este é o valor padrão.)
  • Interno
  • Externo
Type:VirtualDirectoryUriScope
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

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.