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 ha reemplazado 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.
Syntax
Test-WebServicesConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-AllowUnsecureAccess]
[-Confirm]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-UseAutodiscoverForClientAccessServer]
[-WhatIf]
[<CommonParameters>] Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
-AutoDiscoverServer <ClientAccessServerIdParameter>
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
[-MonitoringContext]
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] 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 tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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 -AllowUnsecureAccessEn 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 MBX01En este ejemplo se prueba la conexión de cliente a Exchange Web Services en el servidor denominado MBX01.
Parámetros
-AllowUnsecureAccess
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-AutoDiscoverServer
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.
| Type: | ClientAccessServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ClientAccessServer
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.
| Type: | ServerIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
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, 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 demás cmdlets (por ejemplo, los cmdlets 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
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.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Identity
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.
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LightMode
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxCredential
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.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxServer
El parámetro MailboxServer especifica la identidad del servidor de buzón de Exchange en el que se ejecuta la prueba.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-MonitoringContext
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).
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResetTestAccountCredentials
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Timeout
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.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-TrustAnySSLCertificate
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UseAutodiscoverForClientAccessServer
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-WhatIf
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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de