Test-OwaConnectivity

Esse cmdlet só está disponível no Exchange Server 2010.

Use o cmdlet Test-OwaConnectivity para verificar se Microsoft Outlook Web App do Office está em execução conforme o esperado. O cmdlet Test-OwaConnectivity pode ser usado para testar Outlook Web App conectividade para todos os diretórios virtuais Microsoft Exchange Server 2010 em um servidor de Acesso ao Cliente especificado para todas as caixas de correio em servidores que executam o Exchange que estão no mesmo site do Active Directory. O cmdlet Test-OwaConnectivity também pode ser usado para testar a conectividade de uma URL do Exchange Outlook Web App individual.

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

Syntax

Test-OwaConnectivity
    [-URL] <String>
    -MailboxCredential <PSCredential>
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]
Test-OwaConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-RSTEndpoint <String>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Description

O cmdlet Test-OwaConnectivity testa a conectividade de todos os diretórios virtuais do Exchange Outlook Web App em um servidor de Acesso ao Cliente ou testa a conectividade de uma única URL do Exchange Outlook Web App.

Para testar todos os diretórios virtuais do Exchange Outlook Web App em um servidor de Acesso ao Cliente, deve haver uma conta do Active Directory de teste. Também deve haver uma caixa de correio de teste em cada site do Active Directory que hospeda caixas de correio que podem ser acessadas por meio dos diretórios virtuais que estão sendo testados. Se o ambiente de teste não foi criado durante a instalação do servidor da caixa de correio, você será solicitado a executar o script que cria as caixas de correio de teste e testar os usuários ao executar o cmdlet Test-OwaConnectivity.

Se o servidor que hospeda a caixa de correio de teste não estiver disponível, o cmdlet Test-OwaConnectivity retornará um erro que pode não identificar claramente o problema. Para evitar isso, verifique se o servidor que hospeda a caixa de correio de teste está em execução e se a caixa de correio está disponível antes de executar o cmdlet Test-OwaConnectivity. Você pode usar o cmdlet Test-MapiConnectivity para fazer isso.

Se você executar o cmdlet Test-OwaConnectivity em um servidor de Acesso ao Cliente sem usar o parâmetro ClientAccessServer ou o parâmetro URL, o cmdlet testará o servidor no qual você executa o cmdlet. Para testar um servidor de Acesso ao Cliente específico, use o parâmetro ClientAccessServer.

Para testar uma única URL, execute o cmdlet Test-OwaConnectivity com o parâmetro de URL e as credenciais de uma caixa de correio do Exchange existente. Se a URL estiver atrás de um balanceador de carga, você não poderá prever qual servidor de Acesso ao Cliente o comando testará. Como as credenciais são necessárias como parte dos parâmetros quando você usa o parâmetro URL, você pode usar qualquer conta para executar o cmdlet Test-OwaConnectivity ao usar o parâmetro URL.

Se o comando encontrar um diretório virtual que não exija SSL (Secure Sockets Layer), o comando ignorará esse diretório, a menos que o parâmetro AllowUnsecureAccess seja usado. Se o parâmetro AllowUnsecureAccess for usado, as comunicações entre servidores serão enviadas em texto claro para fins do teste.

O cmdlet Test-OwaConnectivity pode ser executado como uma tarefa interativa única ou como uma tarefa agendada em Microsoft controle do System Center Operations Manager 2007. Para executar o cmdlet Test-OwaConnectivity como uma tarefa do System Center Operations Manager 2007, a caixa de correio de teste acesso ao cliente deve estar disponível nos servidores da caixa de correio em que o cmdlet testa.

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-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)

Este exemplo testa a conectividade da URL https://mail.contoso.com/owa usando as credenciais para o usuário contoso\kweku.

Exemplo 2

Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess

Este exemplo testa a conectividade de um servidor específico do Client Access Contoso12 e testa todos os diretórios virtuais do Exchange Outlook Web App que dão suporte a caixas de correio do Exchange. Estes incluem os diretórios virtuais que não exigem SSL.

Parâmetros

-AllowUnsecureAccess

A opção AllowUnsecureAccess especifica se diretórios virtuais que não exigem SSL são testados. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, o comando ignorará diretórios virtuais que não exigem SSL e um erro será gerado.

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

-ClientAccessServer

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

O parâmetro ClientAccessServer especifica o nome do servidor de Acesso ao Cliente a ser testado. Se esse parâmetro estiver incluído, todos os diretórios virtuais do Exchange Outlook Web App no servidor de Acesso ao Cliente serão testados em todos os servidores do Exchange Mailbox no site do Active Directory local.

Não use esse parâmetro com o parâmetro URL.

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

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

-DomainController

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 2010

-LightMode

O parâmetro LightMode não é implementado para este comando de diagnóstico. Usar esse parâmetro não altera o comportamento do comando.

Esse parâmetro é implementado para outros comandos de diagnóstico do Exchange em que ele é usado para executar uma versão menos intensiva de um comando.

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

-MailboxCredential

O parâmetro MailboxCredential especifica a credencial da caixa de correio para um único teste de URL.

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.

O parâmetro MailboxCredential é necessário somente ao usar o parâmetro URL.

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

-MailboxServer

O parâmetro MailboxServer especifica o nome do servidor mailbox a ser testado. Se não for especificado, todos os servidores de caixa de correio no site do Active Directory local serão testados.

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

-MonitoringContext

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

-ResetTestAccountCredentials

A opção ResetTestAccountCredentials redefine a senha da conta de teste usada para executar esse comando. Não é preciso especificar um valor com essa opção.

A senha da conta de teste normalmente é redefinida a cada sete dias. Use esta opção para forçar uma redefinição de senha, sempre que ela for necessária por razões de segurança.

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

-RSTEndpoint

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 Server 2010

-TestType

O parâmetro TestType especifica se o comando testa URLs internas ou externas. Os valores são Internal e External. Você não pode usar esse parâmetro com o parâmetro URL. Quando nem o parâmetro TestType nem o parâmetro URL são especificados, o padrão é TestType:Internal.

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

-Timeout

O parâmetro Timeout especifica o tempo, em segundos, a ser aguardado até a conclusão da operação de teste. O valor-padrão do parâmetro Timeout é de 30 segundos. Você deve especificar um valor de tempo limite maior que 0 segundos e menor que 1 hora (3.600 segundos). Recomendamos que você sempre configure esse parâmetro com um valor de 5 segundos ou mais.

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

-TrustAnySSLCertificate

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

-URL

O parâmetro URL especifica a URL a ser testada. Esse parâmetro é necessário somente quando você deseja testar uma ÚNICA URL de Outlook Web App.

Se esse parâmetro for usado, o parâmetro MailboxCredential também será necessário.

Você não pode usar o parâmetro URL com os parâmetros TestType ou ClientAccessServer.

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

-VirtualDirectoryName

O parâmetro VirtualDirectoryName especifica o nome do diretório virtual a ser testado em um servidor de acesso ao cliente específico. Se esse parâmetro não estiver incluído, todos os diretórios virtuais do Exchange Outlook Web App que dão suporte às caixas de correio do Exchange serão testados.

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

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