Test-OwaConnectivity
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2010-08-18
Use o cmdlet Test-OwaConnectivity para verificar se o Microsoft Office Outlook Web Access está em execução conforme esperado. O cmdlet Test-OwaConnectivity pode ser usado para testar a conectividade do Outlook Web Access em todos os diretórios virtuais do Microsoft Exchange 2007 em um servidor de Acesso para Cliente especificado para todas as caixas de correio de servidores Exchange 2007 no mesmo site do Active Directory. O cmdlet Test-OwaConnectivity também pode ser usado para testar a conectividade de uma URL individual do Exchange 2007 Outlook Web Access.
Sintaxe
Test-OwaConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-TestType <Internal | External>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>] [-WhatIf [<SwitchParameter>]]
Test-OwaConnectivity [-URL <String>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet Test-OwaConnectivity pode ser usado para testar a conectividade de todos os diretórios virtuais do Exchange 2007 Outlook Web Access em um servidor de Acesso para Cliente ou para testar a conectividade de uma única URL do Exchange 2007 Outlook Web Access.
Para testar todos os diretórios virtuais do Exchange 2007 Outlook Web Access em um servidor de Acesso para Cliente, deve haver uma conta de teste do Active Directory. Deve haver também uma caixa de correio de teste em cada servidor Exchange 2007 que tenha a função de servidor Caixa de Correio instalada que possa ser acessada por diretórios virtuais que estejam sendo testados. As contas de teste e as caixas de correio de teste podem ser criadas durante uma etapa na instalação do servidor de Caixa de Correio. Se o ambiente de teste não foi criado durante a instalação do servidor de Caixa de Correio, será solicitado que você execute o script que cria as caixas de correio de teste e os usuários de teste ao executar o cmdlet Test-OwaConnectivity.
Se o servidor que estiver hospedando a caixa de correio não estiver disponível, o cmdlet Test-OWAConnectivity retornará um erro que pode não identificar o problema claramente. Para evitar isso, verifique se o servidor que hospeda a caixa de correio de teste está sendo executado e se a caixa de correio está disponível antes de executar o cmdlet Test-OWAConnectivity.
Se você executar o cmdlet Test-OwaConnectivity em um servidor de Acesso para Cliente sem usar o parâmetro ClientAccessServer ou o parâmetro URL, o cmdlet testará o servidor no qual deverá executar o cmdlet. Para testar um servidor de Acesso para Cliente específico, use o parâmetro ClientAccessServer.
Para executar o cmdlet Test-OwaConnectivity para testar a conectividade do Outlook Web Access em todos os diretórios virtuais do Exchange 2007 em um servidor de Acesso para Cliente, a conta usada deve ter a função Administrador do Exchange Server e a associação no grupo Administradores local do servidor de destino.
Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.
Para testar uma única URL, execute o Test-OwaConnectivity com o parâmetro URL e credenciais de uma caixa de correio existente do Exchange 2007. Se a URL estiver atrás de um balanceador de carga, você não poderá prever que servidor de Acesso para Cliente o cmdlet testará. Como as credenciais são necessárias como parte dos parâmetros quando você usa o parâmetro URL, qualquer conta pode ser usada para executar Test-OwaConnectivity quando você usar o parâmetro URL.
Se o cmdlet encontrar um diretório virtual que não exija SSL (Secure Sockets Layer), ele ignorará esse diretório a menos que o parâmetro AllowUnsecureAccess seja usado. Se o parâmetro AllowUnsecureAccess for usado, a comunicação entre os servidores será enviada em texto não criptografado para fins de teste.
O cmdlet Test-OwaConnectivity pode ser executado como uma tarefa interativa única ou como uma tarefa agendada em controle de MOM (Microsoft Operations Manager). Se você quiser executar o Test-OwaConnectivity como uma tarefa do MOM, o ambiente de teste do Acesso para Cliente deve estar disponível nos servidores de Caixa de Correio que serão testados pelo cmdlet.
Parâmetros
| Parâmetro | Necessário(s) | Tipo | Descrição |
|---|---|---|---|
AllowUnsecureAccess |
Opcional |
System.Management.Automation.SwitchParameter |
Se estiver incluído, esse parâmetro permitirá que diretórios virtuais que não exigem SSL sejam testados. Se esse parâmetro não estiver incluído, a tarefa ignorará os diretórios virtuais que não exigem SSL e será gerado um erro. |
ClientAccessServer |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Esse parâmetro especifica o nome do servidor de Acesso para Cliente para teste. Se esse parâmetro estiver incluído, todos os diretórios virtuais do Exchange 2007 Outlook Web Access no servidor de Acesso para Cliente serão testados em relação a todos os servidores de Caixa de Correio do Exchange 2007 no site local do Active Directory. Os diretórios virtuais do Microsoft Exchange 2000 Server e do Microsoft Exchange Server 2003 não serão testados. As Caixas de Correio que não estiverem nos servidores de Caixa de Correio do Exchange 2007 não serão testadas. Não use esse parâmetro com o parâmetro URL. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no cmdlet. |
LightMode |
Opcional |
System.Management.Automation.SwitchParameter |
Este parâmetro não é implementado para o cmdlet de diagnóstico Test-OwaConnectivity. Usar este parâmetro não altera o comportamento do cmdlet. Dica Este cmdlet é implementado para outros cmdlets de diagnóstico do Exchange 2007. Mais especificamente, ele é usado em casos em que se deseja executar uma versão menos intensiva de um cmdlet. |
MailboxCredential |
Opcional |
System.Management.Automation.PSCredential |
Esse parâmetro inclui a credencial de caixa de correio para um teste único de URL. |
MailboxServer |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Esse parâmetro especifica o nome do servidor de Caixa de Correio a ser testado. Se não for especificado, todos os servidores de Caixa de Correio no site local do Active Directory serão testados. |
MonitoringContext |
Opcional |
System.Management.Automation.SwitchParameter |
Se esse parâmetro estiver incluído, a tarefa será executada pelo agendamento do MOM. A execução da tarefa com esse parâmetro sem MOM provocará a falha da tarefa. Se esse parâmetro for excluído, a tarefa deverá ser executada por um administrador. |
ResetTestAccountCredentials |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro ResetTestAccountCredentials redefine a senha da conta de teste usada para executar esse comando. Geralmente, a senha da conta de teste é redefinida a cada sete dias, caso você esteja usando o Microsoft System Center Operations Manager para gerenciar o ambiente do Exchange. O uso desse sinalizador força uma redefinição de senha a qualquer momento, se isso for necessário por razões de segurança. |
Site |
Opcional |
Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter |
O parâmetro Site é usado para especificar um site do Active Directory. |
TestType |
Opcional |
Microsoft.Exchange.Monitoring.OwaConnectivityTestType |
Esse parâmetro determina se o cmdlet testará URLs internas ou externas. Os valores são Interna e Externa. Esse parâmetro não pode ser usado junto com o parâmetro URL. Quando nenhum dos parâmetros,TestType ou URL estiver especificado, o padrão será TestType:Internal |
Timeout |
Opcional |
System.UInt32 |
Esse parâmetro especifica quanto tempo será preciso aguardar até a conclusão da operação de teste (em segundos). O valor padrão de Timeout é 30 segundos. Você deve especificar um valor de tempo limite maior que 0 segundos e menor que 1 hora (3600 segundos). Recomendamos que você sempre configure esse parâmetro com um valor de 5 segundos ou mais. |
TrustAnySSLCertificate |
Opcional |
System.Management.Automation.SwitchParameter |
Se esse parâmetro for usado, as falhas de validação do certificado SSL não serão informadas. Isso é útil para testar URLs internas, pois o IIS (Internet Information Services) não aceita a atribuição de vários certificados para um único diretório virtual. Se um diretório tiver diferentes URLs para acesso interno e externo e tiver um certificado, esse certificado geralmente será para a URL externa. Esse parâmetro permite que a tarefa verifique uma URL interna sem gerar um erro, quando o certificado não corresponder à URL. |
URL |
Opcional |
System.String |
Esse parâmetro especifica a URL do Outlook Web Access a ser testada. Se esse parâmetro for usado, somente a URL especificada será testada. Não use o parâmetro URL com o parâmetro ClientAccessServer. O parâmetro URL não pode ser usado com o parâmetro TestType. |
VirtualDirectoryName |
Opcional |
System.String |
Esse parâmetro especifica o nome do diretório virtual a ser testado em um servidor específico de Acesso para Cliente. Se esse parâmetro não estiver incluído, todos os diretórios virtuais do Outlook Web Access que oferecem suporte a caixas de correio do Exchange 2007 serão testados. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma delas. Você não precisará especificar um valor para o parâmetro WhatIf. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
O primeiro exemplo de código testa a conectividade da URL https://mail.contoso.com/owa, com as credenciais do usuário contoso\kweku.
O segundo exemplo de código testa a conectividade de um servidor de Acesso para Cliente específico, chamado Contoso12 e testará todos os diretórios virtuais do Outlook Web Access que ofereçam suporte a caixas de correio do Exchange 2007. Entre esses estão os diretórios virtuais que não necessitam de SSL.
Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)
Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess