Test-WebServicesConnectivity

Artigo
09/30/2014

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2010-08-18

O cmdlet Test-WebServicesConnectivity executa operações básicas para verificar a funcionalidade dos Serviços da Web do Exchange em um computador do Microsoft Exchange Server 2007 em que a função de servidor Acesso para Cliente esteja instalada.

Sintaxe

Test-WebServicesConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-UseAutodiscoverForClientAccessServer <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Test-WebServicesConnectivity permite testar a funcionalidade dos Serviços Web do Exchange. Se o teste falhar, uma mensagem será exibida no Shell de Gerenciamento do Exchange.

Para executar o cmdlet Test-WebServicesConnectivity, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange Server e o 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 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário(s)	Tipo	Descrição
AllowUnsecureAccess	Opcional	System.Management.Automation.SwitchParameter	Esse parâmetro permite que o cmdlet Test-WebServicesConnectivity continue a execução por um canal não protegido que não exija SSL.
ClientAccessServer	Opcional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Esse parâmetro especifica o servidor de Acesso para Cliente a ser usado quando o cmdlet Test-WebServicesConnectivity é executado.
Confirm	Opcional	System.Management.Automation.SwitchParameter	Esse parâmetro 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	O parâmetro DomainController especifica o controlador de domínio a ser usado para gravar essa alteração de configuração no serviço de diretório do Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado.
LightMode	Opcional	System.Management.Automation.SwitchParameter	Este parâmetro não é implementado para o cmdlet de diagnóstico Test-PopConnectivity. Usar este parâmetro não altera o comportamento do cmdlet. Nota Este cmdlet é implementado para outros cmdlets de diagnóstico do Exchange 2007. 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 parâmetro especifica a caixa de correio a ser usada quando o cmdlet Test-WebServicesConnectivity é executado.
MailboxServer	Opcional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Esse parâmetro especifica a identidade do servidor de Caixa de Correio do Exchange 2007 no qual o teste será executado.
MonitoringContext	Opcional	System.Management.Automation.SwitchParameter	Esse parâmetro especifica se o resultado do teste será passado para o MOM (Microsoft Operations Manager). Se esse parâmetro estiver definido como `$true`, o resultado do teste será passado para o MOM. Se esse parâmetro for definido como `$false`, o resultado do teste será exibido apenas na linha de comando.
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	Optional	Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter	O parâmetro Site é usado para especificar um site do Active Directory.
Timeout	Optional	System.UInt32	O parâmetro Timeout especifica quanto tempo será preciso aguardar, em segundos, até a conclusão da operação de teste. O valor padrão do parâmetro Timeout é de 300 segundos. Você deve especificar um valor de tempo limite maior que 0 segundos. Recomendamos que você sempre configure esse parâmetro com um valor de 5 segundos ou mais.
TrustAnySSLCertificate	Opcional	System.Management.Automation.SwitchParameter	Esse parâmetro permite testar o uso de qualquer certificado SSL disponível.
UseAutodiscoverForClientAccessServer	Opcional	System.Management.Automation.SwitchParameter	Esse parâmetro especifica se o teste deve usar o serviço de Descoberta Automática para localizar o servidor de Acesso para Cliente.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	Este parâmetro instrui o comando a simular as ações que ele executaria no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar nenhum valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

O exemplo de código a seguir testa os Serviços Web do Exchange no servidor de Acesso para Cliente local e permite testar o uso de uma conexão não protegida que não exija SSL. Uma conta de teste padrão será usada.

Test-WebServicesConnectivity -AllowUnsecureAccess

Compartilhar via