Test-WebServicesConnectivity
Este cmdlet solo está disponible en el entorno local de Exchange.
Use el cmdlet Test-WebServicesConnectivity para probar la conectividad del cliente con directorios virtuales de Exchange Web Services.
Nota: Este cmdlet funciona mejor en Exchange 2010. En versiones posteriores de Exchange, la funcionalidad de este cmdlet se reemplaza por Disponibilidad administrada. Para obtener los mejores resultados, use el cmdlet Invoke-MonitoringProbe y especifique el sondeo de monitor activo pertinente en lugar de usar este cmdlet.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Sintaxis
Default
Test-WebServicesConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-AllowUnsecureAccess]
[-Confirm]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-UseAutodiscoverForClientAccessServer]
[-WhatIf]
[<CommonParameters>]
AutoDiscoverServer
Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
-AutoDiscoverServer <ClientAccessServerIdParameter>
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>]
MonitoringContext
Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
[-MonitoringContext]
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>]
ClientAccessServer
Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
[-ClientAccessServer <ClientAccessServerIdParameter>]
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>]
Description
El cmdlet Test-WebServicesConnectivity prueba la conectividad de Exchange Web Services mediante la conexión a un directorio virtual de Servicios web de Exchange especificado, a cualquier directorio virtual de Exchange Web Services en un servidor de Exchange especificado o a cualquier directorio virtual de Exchange Web Services que esté disponible en el sitio local de Active Directory.
La primera vez que use este cmdlet es posible que tenga que crear un usuario de prueba. Para crear un usuario de prueba, ejecute el siguiente comando:
& $env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1
Los resultados de la prueba se muestran en pantalla. El cmdlet devuelve la siguiente información.
- Origen: servidor de origen.
- ServiceEndpoint: servidor de destino.
- Escenario: las operaciones que se prueban. Los valores son Autodiscover: SOAP Provider y EWS: GetFolder (modo completo) o EWS: ConvertID (modo ligero).
- Resultado: los valores devueltos suelen ser Correcto o *FAILURE*.
- Latencia (MS): tiempo necesario para completar la prueba en milisegundos
Puede escribir los resultados en un archivo canalizando la salida a ConvertTo-Html y Set-Content. Por ejemplo: Test-WebServicesConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\EWS Test.html".
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
Test-WebServicesConnectivity -AllowUnsecureAccess
En Exchange 2010, en este ejemplo se prueban los servicios web de Exchange en el servidor de acceso de cliente local y se permite que la prueba use una conexión no segura que no requiera SSL. Se usa una cuenta de prueba predeterminada.
Ejemplo 2
Test-WebServicesConnectivity -ClientAccessServer MBX01
En este ejemplo se prueba la conexión de cliente a Exchange Web Services en el servidor denominado MBX01.
Parámetros
-AllowUnsecureAccess
Aplicable: Exchange Server 2010
Este parámetro solo está disponible en Exchange Server 2010.
El modificador AllowUnsecureAccess especifica si se va a permitir que el comando continúe ejecutándose a través de un canal no seguro que no requiera capa de sockets seguros (SSL). No es necesario especificar un valor con este modificador.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AutoDiscoverServer
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
El parámetro AutoDiscoverServer especifica el servidor con el rol de servidor Acceso de clientes instalado que se usa para Detección automática.
Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:
- Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:
- Nombre (por ejemplo, Exchange01)
- Nombre distintivo (DN) (por ejemplo, CN=Exchange01,CN=Servers,CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,CN=First Organization,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=contoso,DC=com)
- DN heredado de Exchange (por ejemplo, /o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=Exchange01)
Este parámetro no se puede usar con el parámetro ClientAccessServer.
Propiedades del parámetro
| Tipo: | ClientAccessServerIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AutoDiscoverServer
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
ClientAccessServer
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ClientAccessServer
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
El parámetro ClientAccessServer especifica el servidor de Exchange que se va a probar. Este servidor tiene instalado el rol de servidor acceso de cliente y es responsable de aceptar las conexiones de cliente.
Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:
- Nombre
- Nombre completo (DN)
- ExchangeLegacyDN
- GUID
Este parámetro no se puede usar con el parámetro AutoDiscoverServer.
Propiedades del parámetro
| Tipo: | ServerIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Default
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
ClientAccessServer
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DomainController
Aplicable: Exchange Server 2010
Este parámetro solo está disponible en Exchange Server 2010.
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.
Propiedades del parámetro
| Tipo: | Fqdn |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
El parámetro Identity especifica el buzón de correo que se va a usar para la prueba. Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre completo (DN)
- Dominio\Nombre de usuario
- Dirección de correo electrónico
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuario o nombre de la entidad de seguridad de usuario (UPN)
Si usa este parámetro, también deberá usar el parámetro MailboxCredential.
Propiedades del parámetro
| Tipo: | MailboxIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AutoDiscoverServer
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
MonitoringContext
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
ClientAccessServer
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-LightMode
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
El modificador LightMode indica al comando que realice únicamente un subconjunto de las pruebas. No es necesario especificar un valor con este modificador.
Al usar este modificador, el EWS: La prueba ConvertId se ejecuta en lugar de EWS: La prueba GetFolder.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-MailboxCredential
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
El parámetro MailboxCredential especifica la credencial de buzón que se va a usar para una prueba de buzón de correo única.
Un valor para este parámetro requiere el cmdlet Get-Credential. Para pausar este comando y recibir una solicitud de credenciales, use el valor (Get-Credential). O bien, antes de ejecutar este comando, almacene las credenciales en una variable (por ejemplo, $cred = Get-Credential) y, a continuación, use el nombre de variable ($cred) para este parámetro. Para más información, vea Get-Credential.
Este parámetro es necesario cuando se usa el parámetro Identity.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-MailboxServer
Aplicable: Exchange Server 2010
El parámetro MailboxServer especifica la identidad del servidor de buzón de Exchange en el que se ejecuta la prueba.
Propiedades del parámetro
| Tipo: | ServerIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-MonitoringContext
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
El conmutador MonitoringContext incluye o excluye los eventos de supervisión y contadores de rendimiento asociados en los resultados. No es necesario especificar un valor con este modificador.
Normalmente, se incluyen los eventos de supervisión y los contadores de rendimiento en los resultados cuando la salida se pasa a Microsoft System Center Operations Manager (SCOM).
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
MonitoringContext
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ResetTestAccountCredentials
Aplicable: Exchange Server 2010
El modificador ResetTestAccountCredentials restablece la contraseña de la cuenta de prueba que se usa para ejecutar este comando. No es necesario especificar un valor con este modificador.
La contraseña de la cuenta de prueba se suele restablecer normalmente cada siete días. Use este modificador para obligar a restablecer la contraseña siempre que sea necesario por motivos de seguridad.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Timeout
Aplicable: Exchange Server 2010
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 especificar un valor de tiempo de espera mayor que 0 segundos. Le recomendamos que configure siempre este parámetro con un valor de 5 segundos o más.
Propiedades del parámetro
| Tipo: | UInt32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TrustAnySSLCertificate
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
El modificador TrustAnySSLCertificate permite a Exchange aceptar certificados de entidades de certificación (CA) que no son de confianza. No es necesario especificar un valor con este modificador.
El modificador TrustAnySSLCertificate especifica si se deben omitir los errores de validación de certificado de Secure Sockets Layer (SSL). No es necesario especificar un valor con este modificador.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-UseAutodiscoverForClientAccessServer
Aplicable: Exchange Server 2010
Este parámetro solo está disponible en Exchange Server 2010.
El modificador UseAutodiscoverForClientAccessServer especifica si la prueba debe usar el servicio Detección automática para buscar el servidor de acceso de cliente. No es necesario especificar un valor con este modificador.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.
Entradas
Input types
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Output types
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.