Test-OwaConnectivity
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2010-08-18
Utilice el cmdlet Test-OwaConnectivity para comprobar que Microsoft Office Outlook Web Access se está ejecutando según lo esperado. El cmdlet Test-OwaConnectivity se puede usar para probar la capacidad de conexión de Outlook Web Access para todos los directorios virtuales de Microsoft Exchange 2007 en un servidor de acceso de cliente especificado para todos los buzones en servidores de Exchange 2007 que estén en el mismo sitio de Active Directory. Test-OwaConnectivity se puede usar también para probar la capacidad de conexión para una dirección URL individual de Exchange 2007 Outlook Web Access.
Sintaxis
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>]]
Descripción detallada
El cmdlet Test-OwaConnectivity se puede utilizar para probar la conectividad de todos los directorios virtuales de Exchange 2007 Outlook Web Access en un servidor de acceso de cliente, o para probar la conectividad de una única URL de Exchange 2007 Outlook Web Access.
Para probar todos los directorios virtuales de Exchange 2007 Outlook Web Access en un servidor de acceso de cliente, deberá existir una cuenta de prueba de Active Directory. Asimismo, deberá existir un buzón de prueba en cada servidor de Exchange 2007 que tenga instalada la función del servidor Buzón de correo a la que se pueda obtener acceso a través de los directorios virtuales que se estén probando. Puede crear cuentas y buzones de prueba durante un paso de la configuración del servidor de buzones. Si no se creó el entorno de prueba durante la configuración del servidor de buzones, se le pedirá que ejecute el script que crea los buzones y los usuarios de prueba al ejecutar el cmdlet Test-OwaConnectivity.
Si el servidor que hospeda el buzón de prueba no está disponible, el cmdlet Test-OWAConnectivity cmdlet devolverá un error que puede no identificar claramente el problema. Para evitarlo, compruebe que el servidor que hospeda el buzón de prueba funcione y que el buzón esté disponible antes de ejecutar el cmdlet Test-OWAConnectivity.
Si ejecuta el cmdlet Test-OwaConnectivity en un servidor de acceso de cliente sin utilizar los parámetros ClientAccessServer o URL, el cmdlet probará el servidor en el que ejecute el cmdlet. Para probar un determinado servidor de acceso de cliente, utilice el parámetro ClientAccessServer.
Para ejecutar el cmdlet Test-OwaConnectivity para probar la conectividad de Outlook Web Access para todos directorios virtuales de Exchange 2007 de un servidor Acceso de clientes, se debe delegar en la cuenta que use la función Administrador de Exchange Server y pertenecer al grupo local de administradores del 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 Server 2007, consulte Consideraciones sobre permisos.
Para probar una sola URL, ejecute Test-OwaConnectivity con el parámetro URL y las credenciales para un buzón de Exchange 2007 existente. Si la dirección URL está detrás de un equilibrador de carga, no se puede predecir qué servidor de acceso de cliente probará el cmdlet. Debido a que las credenciales son parte necesaria de los parámetros cuando se usa el parámetro URL, puede utilizar cualquier cuenta para ejecutar Test-OwaConnectivity cuando se utiliza el parámetro URL.
Si el cmdlet encuentra un directorio virtual que no precisa de Nivel de sockets seguros (SSL), se saltará ese directorio, a no ser que se utilice el parámetro AllowUnsecureAccess. Si se utiliza el parámetro AllowUnsecureAccess, la comunicación entre servidores se enviará en texto sin cifrar para realizar la prueba.
El cmdlet Test-OwaConnectivity puede ejecutarse como una tarea interactiva de una sola vez, o como una tarea programada bajo el control de Microsoft Operations Manager (MOM). Para ejecutar Test-OwaConnectivity como una tarea de MOM, el entorno de prueba de acceso de cliente tiene que estar disponible en los servidores de correo en los que hará las comprobaciones el cmdlet.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
AllowUnsecureAccess |
Opcional |
System.Management.Automation.SwitchParameter |
Si se incluye, este parámetro permite hacer pruebas en los directorios virtuales que no precisen SSL. Si este parámetro no se incluye, la tarea no se ejecutará en los directorios virtuales que no requieran SSL y se generará un error. |
ClientAccessServer |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Este parámetro especifica el nombre del servidor de acceso de cliente habilitado que se va a probar. Si este parámetro está incluido, todos los directorios virtuales de Exchange 2007 Outlook Web Access del servidor de acceso de cliente se probarán sobre todos los servidores de buzones de Exchange 2007 en el sitio local de Active Directory. Los directorios virtuales de Microsoft Exchange 2000 Server y Microsoft Exchange Server 2003 no se probarán. Los buzones que no estén en servidores de buzones de Exchange 2007 no se probarán. No utilice este parámetro con el parámetro URL. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm 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 |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que recupera los datos del servicio de directorio de Active Directory, incluya el parámetro DomainController en el cmdlet. |
LightMode |
Opcional |
System.Management.Automation.SwitchParameter |
Este parámetro no está implementado para el cmdlet de diagnóstico Test-OwaConnectivity. El uso de este parámetro no modifica el comportamiento del cmdlet. Nota Este cmdlet está implementado para otros cmdlet de diagnóstico de Exchange 2007. En concreto, se usa en casos en los que desea ejecutar una versión menos intensiva de un cmdlet. |
MailboxCredential |
Opcional |
System.Management.Automation.PSCredential |
Este parámetro incluye una credencial de buzón para una prueba de una sola URL. |
MailboxServer |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Este parámetro especifica el nombre del servidor de buzones que se va a probar. Si no se especifica, se probarán todos los servidores de buzones del sitio de Active Directory. |
MonitoringContext |
Opcional |
System.Management.Automation.SwitchParameter |
Si se incluye, este parámetro ejecutará la tarea mediante programación MOM. Al ejecutar esta tarea con este parámetro sin MOM, la tarea generará un error. Si se excluye este parámetro, la tarea tiene que ejecutarse de forma interactiva por parte de un administrador. |
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. |
TestType |
Opcional |
Microsoft.Exchange.Monitoring.OwaConnectivityTestType |
Este parámetro determina si el cmdlet probará direcciones URL internas o externas. Los valores son Internal y External. Este parámetro no se puede usar junto con el parámetro URL. Cuando no se especifican los parámetros TestType ni URL, el valor predeterminado es TestType:Internal. |
Timeout |
Opcional |
System.UInt32 |
Este parámetro especifica la cantidad de tiempo que hay que esperar para que se complete la operación de prueba (en segundos). El valor predeterminado de Timeout es de 30 segundos. Debe especificar un valor de Timeout mayor de 0 segundos y menor de 1 hora (3.600 segundos). Le recomendamos que configure siempre este parámetro con un valor de 5 segundos o más. |
TrustAnySSLCertificate |
Opcional |
System.Management.Automation.SwitchParameter |
Si se utiliza este parámetro, los errores de validación del certificado SSL no se comunican. Esto resulta útil para probar direcciones URL internas puesto que Internet Information Services (IIS) no admite la asignación de varios certificados para un único directorio virtual. Si un directorio tiene direcciones URL distintas para el acceso interno y el externo y tiene un certificado, ese certificado será normalmente para la URL externa. Este parámetro permite a la tarea comprobar una dirección URL interna sin generar un error, cuando el certificado no coincide con la dirección URL. |
URL |
Opcional |
System.String |
Este parámetro especifica la URL de Outlook Web Access que se va a probar. Si se utiliza este parámetro, sólo se probará la dirección URL especificada. No utilice el parámetro URL con el parámetro ClientAccessServer. El parámetro URL no puede utilizarse con el parámetro TestType. |
VirtualDirectoryName |
Opcional |
System.String |
Este parámetro especifica el nombre del directorio virtual que se probará en un determinado servidor de acceso de cliente. Si no se incluye este parámetro, se probarán todos los directorios virtuales de Outlook Web Access compatibles con buzones de Exchange 2007. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar ningún valor con el parámetro WhatIf. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
El primer ejemplo de código prueba la conectividad para la dirección URL https://mail.contoso.com/owa utilizando las credenciales para el usuario contoso\kweku.
El segundo ejemplo de código prueba la conectividad de un determinado servidor de acceso de cliente llamado Contoso12 y probará todos los directorios virtuales de Outlook Web Access que admiten buzones de Exchange 2007. Eso incluye los directorios virtuales que no precisan SSL
Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)
Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess