Test-OwaConnectivity (RTM)
Se aplica a: Exchange Server 2007
Ú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 utilizar para probar la conectividad de Outlook Web Access en todos los directorios virtuales de Microsoft Exchange 2007 ubicados en un servidor de acceso de cliente especificado para todos los buzones de servidores de Exchange 2007 que están en el mismo sitio de Active Directory. Test-OwaConnectivity también puede utilizarse para probar la conectividad para una sola dirección URL de Exchange 2007 Outlook Web Access.
Sintaxis
Test-OwaConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-DomainController <Fqdn>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-TestType <Internal | External>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>]
Test-OwaConnectivity [-URL <String>] [-AllowUnsecureAccess <SwitchParameter>] [-DomainController <Fqdn>] [-MailboxCredential <PSCredential>] [-ResetTestAccountCredentials <SwitchParameter>] [-TrustAnySSLCertificate <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 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 contra 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. |
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 Active Directory, incluya el parámetro DomainController en el 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. |
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 puede utilizarse con el parámetro URL. Cuando no se especifican los parámetros TestType ni URL, el valor predeterminado es TestType:Internal. |
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. |
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