Test-ActiveSyncConnectivity
Este cmdlet solo está disponible en el entorno local de Exchange.
Use el cmdlet Test-ActiveSyncConnectivity para probar la conectividad con los directorios virtuales de Microsoft Exchange ActiveSync.
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-ActiveSyncConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[[-URL] <String>]
[-AllowUnsecureAccess]
[-Confirm]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>]
[-MonitoringContext]
[-MonitoringInstance <String>]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-UseAutodiscoverForClientAccessServer]
[-WhatIf]
[<CommonParameters>] Description
El cmdlet Test-ActiveSyncConnectivity prueba Exchange ActiveSync conectividad mediante la conexión a un directorio virtual Exchange ActiveSync especificado, a cualquier directorio virtual de Exchange ActiveSync en un servidor de Exchange especificado o a cualquier Exchange ActiveSync directorios virtuales que están disponibles en el sitio de Active Directory local.
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.
- CasServer: el servidor de Exchange al que se conectó el cliente.
- LocalSite: nombre del sitio de Active Directory local.
- Escenario: las operaciones que se prueban. Los valores son: Options, FolderSync, First Sync, GetItemEstimate, Sync Data, Ping y Sync Test Item.
- Resultado: los valores devueltos suelen ser Correcto, Omitido o Error.
- Latencia (MS): tiempo necesario para completar la prueba en milisegundos.
- Error: cualquier mensaje de error que se encontró.
Puede escribir los resultados en un archivo canalizando la salida a ConvertTo-Html y Set-Content. Por ejemplo: Test-ActiveSyncConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\EAS 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-ActiveSyncConnectivity -ClientAccessServer MBX01En este ejemplo se prueba Exchange ActiveSync conectividad de cliente para el servidor denominado MBX01.
Ejemplo 2
Test-ActiveSyncConnectivity -UseAutodiscoverForClientAccessServer $true -URL "https://contoso.com/mail" -MailboxCredential (Get-Credential pauls@contoso.com)En este ejemplo se prueba la conectividad Exchange ActiveSync para el buzón PaulS mediante la dirección URL de detección automática.
Parámetros
-AllowUnsecureAccess
El modificador AllowUnsecureAccess permite a la prueba continuar en un canal no seguro que no requiere 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, 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 de 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 Url.
| 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
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, 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, solo se ejecuta la prueba Options.
Si no usa este modificador, también se ejecutan las pruebas First Sync, GetItemEstimate, Sync Data, Ping y Sync Test Item.
| 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.
| 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 el servidor de buzón de Exchange que desea probar. Este parámetro identifica el servidor back-end que acepta conexiones proxy desde el servidor front-end donde se conectan los clientes.
El parámetro MailboxServer especifica el servidor de buzones de correo de exExchange2k16 o exExchange2k13 que quiere probar. Por ejemplo:
- Nombre
- Nombre completo (DN)
- ExchangeLegacyDN
- GUID
Si no usa este parámetro, se probarán las conexiones a todos los servidores de buzones del sitio local de Active Directory.
| Type: | ServerIdParameter |
| 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 |
-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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MonitoringInstance
El parámetro MonitoringInstance especifica un identificador para esta tarea cuando la prueba se ejecuta desde Microsoft System Center Operations Manager (SCOM). Este parámetro es importante porque SCOM puede ejecutar varias instancias de la prueba desde el mismo servidor al mismo tiempo.
| Type: | String |
| 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 |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Timeout
El parámetro Timeout especifica durante cuánto tiempo (en segundos) se esperará una respuesta del comando.
| Type: | UInt32 |
| 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 |
-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 |
-URL
El parámetro URL especifica la dirección URL que se usa para conectarse al directorio virtual Exchange ActiveSync.
Este parámetro no se puede usar con el parámetro ClientAccessServer.
| Type: | String |
| Position: | 1 |
| 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
El modificador UseAutodiscoverForClientAccessServer especifica si la prueba debe usar el servicio Detección automática para buscar el directorio virtual Exchange ActiveSync. 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 |
-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.