Partilhar via


Test-OwaConnectivity

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

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

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

Sintaxe

URL

Test-OwaConnectivity
    [-URL] <String>
    -MailboxCredential <PSCredential>
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Identity

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 num servidor de Acesso de Cliente ou testa a conectividade de um único URL do Exchange Outlook Web App.

Para testar todos os diretórios virtuais do Exchange Outlook Web App num servidor de Acesso de Cliente, tem de existir uma conta do Active Directory de teste. Também tem de existir uma caixa de correio de teste em cada site do Active Directory que aloje caixas de correio que possam ser acedidas através dos diretórios virtuais que estão a ser testados. Se o ambiente de teste não tiver sido criado durante a configuração do servidor da Caixa de Correio, ser-lhe-á pedido para executar o script que cria as caixas de correio de teste e testar os utilizadores quando executar o cmdlet Test-OwaConnectivity.

Se o servidor que aloja a caixa de correio de teste não estiver disponível, o cmdlet Test-OwaConnectivity devolve um erro que poderá não identificar claramente o problema. Para evitar esta situação, marcar que o servidor que aloja a caixa de correio de teste está em execução e que a caixa de correio está disponível antes de executar o cmdlet Test-OwaConnectivity. Pode utilizar o cmdlet Test-MapiConnectivity para o fazer.

Se executar o cmdlet Test-OwaConnectivity num servidor de Acesso de Cliente sem utilizar o parâmetro ClientAccessServer ou o parâmetro URL, o cmdlet testa o servidor no qual executa o cmdlet. Para testar um servidor de Acesso de Cliente específico, utilize o parâmetro ClientAccessServer.

Para testar um único URL, execute o cmdlet Test-OwaConnectivity com o parâmetro de URL e as credenciais de uma caixa de correio do Exchange existente. Se o URL estiver protegido por um balanceador de carga, não poderá prever o servidor de Acesso de Cliente que o comando testa. Uma vez que as credenciais são necessárias como parte dos parâmetros quando utiliza o parâmetro URL, pode utilizar qualquer conta para executar o cmdlet Test-OwaConnectivity quando utilizar o parâmetro URL.

Se o comando encontrar um diretório virtual que não requer Secure Sockets Layer (SSL), o comando ignora esse diretório, a menos que o parâmetro AllowUnsecureAccess seja utilizado. Se o parâmetro AllowUnsecureAccess for utilizado, as comunicações entre servidores são enviadas em texto claro para efeitos do teste.

O cmdlet Test-OwaConnectivity pode ser executado como uma tarefa interativa única ou como uma tarefa agendada sob o controlo do Microsoft 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 de Acesso de Cliente tem de 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 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

Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)

Este exemplo testa a conectividade do URL https://mail.contoso.com/owa com as credenciais do utilizador contoso\kweku.

Exemplo 2

Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess

Este exemplo testa a conectividade de um servidor de Acesso de Cliente Contoso12 específico e testa todos os diretórios virtuais do Exchange Outlook Web App que suportam caixas de correio do Exchange. Estes incluem os diretórios virtuais que não necessitam de SSL.

Parâmetros

-AllowUnsecureAccess

Aplicável: Exchange Server 2010

O comutador AllowUnsecureAccess especifica se os diretórios virtuais que não necessitam de SSL são testados. Não é preciso especificar um valor com essa opção.

Se não utilizar este comutador, o comando ignora diretórios virtuais que não necessitam de SSL e é gerado um erro.

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

-ClientAccessServer

Aplicável: Exchange Server 2010

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

O parâmetro ClientAccessServer especifica o nome do servidor de Acesso de Cliente a testar. Se este parâmetro estiver incluído, todos os diretórios virtuais do Exchange Outlook Web App no servidor de Acesso de Cliente são testados em todos os servidores da Caixa de Correio do Exchange no site do Active Directory local.

Não utilize este parâmetro com o parâmetro URL.

Propriedades do parâmetro

Tipo:ServerIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

Aplicável: 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, 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

-DomainController

Aplicável: Exchange Server 2010

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

-LightMode

Aplicável: Exchange Server 2010

O parâmetro LightMode não está implementado para este comando de diagnóstico. A utilização deste parâmetro não altera o comportamento do comando.

Este parâmetro é implementado para outros comandos de diagnóstico do Exchange onde é utilizado para executar uma versão menos intensiva de um comando.

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

-MailboxCredential

Aplicável: Exchange Server 2010

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 só é necessário ao utilizar o parâmetro URL.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

URL
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MailboxServer

Aplicável: Exchange Server 2010

O parâmetro MailboxServer especifica o nome do servidor da Caixa de Correio a testar. Se não for especificado, todos os servidores de Caixa de Correio no site do Active Directory local são testados.

Propriedades do parâmetro

Tipo:ServerIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MonitoringContext

Aplicável: 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, inclui os eventos de monitorização e os contadores de desempenho nos resultados quando a saída é transmitida para o Microsoft System Center Operations Manager (SCOM).

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResetTestAccountCredentials

Aplicável: Exchange Server 2010

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.

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

-RSTEndpoint

Aplicável: Exchange Server 2010

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

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TestType

Aplicável: Exchange Server 2010

O parâmetro TestType especifica se o comando testa URLs internas ou externas. Os valores são Internal e External. Não pode utilizar este parâmetro com o parâmetro URL. Quando nem o parâmetro TestType nem o parâmetro URL são especificados, a predefinição é TestType:Internal.

Propriedades do parâmetro

Tipo:OwaConnectivityTestType
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Timeout

Aplicável: Exchange Server 2010

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.

Propriedades do parâmetro

Tipo:UInt32
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

-TrustAnySSLCertificate

Aplicável: Exchange Server 2010

O comutador TrustAnySSLCertificate permite que o Exchange aceite certificados de autoridades de certificação (ACs) não fidedignas. 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.

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

-URL

Aplicável: Exchange Server 2010

O parâmetro URL especifica o URL a testar. Este parâmetro só é necessário quando pretende testar um único URL de Outlook Web App.

Se este parâmetro for utilizado, o parâmetro MailboxCredential também é necessário.

Não pode utilizar o parâmetro URL com os parâmetros TestType ou ClientAccessServer.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

URL
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualDirectoryName

Aplicável: Exchange Server 2010

O parâmetro VirtualDirectoryName especifica o nome do diretório virtual a testar num determinado servidor de Acesso de Cliente. Se este parâmetro não estiver incluído, todos os diretórios virtuais do Exchange Outlook Web App que suportam caixas de correio do Exchange são testados.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

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.