Test-OwaConnectivity
Este cmdlet está disponível apenas no Exchange Server 2010.
Use o cmdlet Test-OwaConnectivity para verificar se o Microsoft Office Outlook Web App está sendo executado conforme o esperado. O cmdlet Test-OwaConnectivity pode ser usado para testar a conectividade Outlook Web App de todos os diretórios virtuais do Microsoft Exchange Server 2010 em um servidor de Acesso para Cliente especificado para todas as caixas de correio em servidores que executam o Exchange que estejam 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 Outlook Web App.
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 em um servidor de Acesso para Cliente ou testa a conectividade de uma única URL de Outlook Web App do Exchange.
Para testar todos os diretórios virtuais do Exchange Outlook Web App em um servidor de Acesso para Cliente, deve haver uma conta de teste do Active Directory. 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 configuração do servidor de Caixa de Correio, você será solicitado a executar 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 hospeda a caixa de correio de teste não estiver disponível, o cmdlet do Test-OwaConnectivity retornará um erro que pode não identificar claramente o problema. Para evitar isso, marcar 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 para 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 para 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 existente do Exchange. Se a URL estiver atrás de um balanceador de carga, você não poderá prever qual servidor de Acesso para Cliente o comando testa. Como as credenciais são necessárias como parte dos parâmetros ao usar o parâmetro URL, você pode usar qualquer conta para executar o cmdlet do Test-OwaConnectivity ao usar o parâmetro URL.
Se o comando encontrar um diretório virtual que não exija TLS, 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 os servidores serão enviadas em texto não criptografado para fins do teste.
O cmdlet Test-OwaConnectivity pode ser executado como uma tarefa interativa única ou como uma tarefa agendada sob o controle 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 para Cliente deve estar disponível nos servidores de 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, 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 do usuário contoso\kweku.
Exemplo 2
Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess
Este exemplo testa a conectividade de um servidor de Acesso para Cliente específico, Contoso12, e testa todos os diretórios virtuais do Exchange Outlook Web App que dão suporte a caixas de correio do Exchange. Incluem os diretórios virtuais que não requerem TLS.
Parâmetros
-AllowUnsecureAccess
Aplicável: Exchange Server 2010
A opção AllowUnsecureAccess especifica se os diretórios virtuais que não exigem TLS 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 TLS e um erro será gerado.
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
Esse parâmetro está disponível apenas no Exchange Server 2010
O parâmetro ClientAccessServer especifica o nome do servidor de Acesso para 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 para Cliente serão testados em todos os servidores de Caixa de Correio do Exchange no site do Active Directory local.
Não use esse 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. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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 esse 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.
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 de 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.
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 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.
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, você inclui os eventos de monitoramento e os contadores de desempenho nos resultados quando a saída é passada 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 é possível 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.
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 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.
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 a URL a ser testada. Esse parâmetro é necessário somente quando você deseja testar uma única URL do Outlook Web App.
Se esse parâmetro for usado, o parâmetro MailboxCredential também será necessário.
Não é possível usar 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 ser testado em um servidor de Acesso para 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 a caixas de correio do Exchange serã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 mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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.