Test-WebServicesConnectivity

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2010-08-18

El cmdlet Test-WebServicesConnectivity realiza operaciones básicas para comprobar la funcionalidad de los servicios web de Exchange en un equipo Microsoft Exchange Server 2007 que tenga instalada la función del servidor Acceso de cliente.

Sintaxis

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

Descripción detallada

El cmdlet Test-WebServicesConnectivity permite probar la funcionalidad de los servicios web de Exchange. Si la prueba da error, se muestra un mensaje en el Shell de administración de Exchange.

Para ejecutar el cmdlet Test-WebServicesConnectivity, se debe delegar la función Administrador de servidor de Exchange y el grupo Administradores local en la cuenta que se use en el servidor de destino.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

AllowUnsecureAccess

Opcional

System.Management.Automation.SwitchParameter

Este parámetro permite que el cmdlet Test-WebServicesConnectivity continúe ejecutándose en un canal no asegurado que no requiera Secure Sockets Layer (SSL).

ClientAccessServer

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Este parámetro especifica el servidor de acceso de cliente a usar cuando se ejecuta el cmdlet Test-WebServicesConnectivity.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Este parámetro hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

El parámetro DomainController indica el controlador de dominio que se debe utilizar para escribir este cambio de configuración en el servicio de directorio Active Directory. Utilice el nombre de dominio completo (FQDN) del controlador de dominio que desee usar.

LightMode

Opcional

System.Management.Automation.SwitchParameter

Este parámetro no está implementado para el cmdlet de diagnóstico Test-PopConnectivity. El uso de este parámetro no modifica el comportamiento del cmdlet.

Nota   Este cmdlet está implementado para otros cmdlets de diagnóstico de Exchange 2007. En concreto, se usa en casos en los que se desee ejecutar una versión menos intensiva de un cmdlet.

MailboxCredential

Opcional

System.Management.Automation.PSCredential

Este parámetro especifica el buzón a usar cuando se ejecuta el cmdlet Test-WebServicesConnectivity.

MailboxServer

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Este parámetro especifica la identidad del servidor de buzones de Exchange 2007 en el que se ejecutará la prueba.

MonitoringContext

Opcional

System.Management.Automation.SwitchParameter

Este parámetro indica si el resultado de la prueba pasa a Microsoft Operations Manager (MOM). Si este parámetro es $true, el resultado de la prueba se pasa a MOM. Si este parámetro es $false, el resultado de la prueba sólo aparece en la línea de comandos.

ResetTestAccountCredentials

Opcional

System.Management.Automation.SwitchParameter

El parámetro ResetTestAccountCredentials restablece la contraseña de la cuenta de prueba usada para ejecutar este comando. Normalmente, la contraseña de la cuenta de prueba se restablece cada siete días si se usa Microsoft System Center Operations Manager para administrar el entorno de Exchange. El uso de esta marca obliga a restablecer la contraseña siempre que sea necesario por motivos de seguridad.

Site

Opcional

Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter

El parámetro Site se usa para especificar el sitio de Active Directory.

Timeout

Opcional

System.UInt32

El parámetro Timeout especifica la cantidad de tiempo, en segundos, que hay que esperar para que se complete la operación de prueba. El valor predeterminado del parámetro Timeout es 300 segundos. Debe especificarse un valor de tiempo superior a 0 segundos. Le recomendamos que configure siempre este parámetro con un valor de 5 segundos o más.

TrustAnySSLCertificate

Opcional

System.Management.Automation.SwitchParameter

Este parámetro permite a la prueba utilizar cualquier certificado SSL disponible.

UseAutodiscoverForClientAccessServer

Opcional

System.Management.Automation.SwitchParameter

Este parámetro indica si la prueba debe utilizar el servicio de detección automática para localizar el servidor de acceso de cliente.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Este parámetro indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

El siguiente ejemplo de código prueba los Servicios Web Exchange en el servidor de acceso de cliente local y permite que la prueba use una conexión no segura que no requiere SSL. Se usará una cuenta de prueba predeterminada.

Test-WebServicesConnectivity -AllowUnsecureAccess