Compartir a través de


Test-OutlookConnectivity

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet Test-OutlookConnectivity para probar la conectividad de cliente Microsoft Outlook de un extremo a otro en la organización Microsoft Exchange. Esto incluye pruebas para Outlook Anywhere (RPC a través de HTTP) y MAPI a través de conexiones HTTP.

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-OutlookConnectivity
    [-ProbeIdentity] <String>
    [-Credential <PSCredential>]
    [-Hostname <String>]
    [-MailboxId <MailboxIdParameter>]
    [-RunFromServerId <ServerIdParameter>]
    [-TimeOutSeconds <String>]
    [<CommonParameters>]
Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -Protocol <Protocol>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]
Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -GetDefaultsFromAutodiscover <Boolean>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyServer <ServerIdParameter>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]
Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -RpcTestType <RpcTestType>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyTestType <RpcProxyTestType>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]
Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -WSTestType <VirtualDirectoryUriScope>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Description

La ejecución del cmdlet Test-OutlookConnectivity valida una conexión de Outlook definida por los parámetros proporcionados. El comando puede validar un único buzón.

El cmdlet Test-OutlookConnectivity ejecuta el mismo proceso que los sondeos de supervisión. El servicio Microsoft Exchange Health Manager (MSExchangeHM) debe estar en ejecución y haber creado los sondeos de Outlook en el equipo que se probarán. Debe seleccionar una de las identidades de sondeo de Outlook para ejecutar la prueba. Use el cmdlet Get-MonitoringItemIdentity para ver qué sondeos están activos.

En este ejemplo se enumeran los sondeos que se ejecutan en los servicios back-end de un servidor de buzones de correo: Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook.protocol | ?{$_.Name -like '*probe'}.

En este ejemplo se enumeran los sondeos que se ejecutan en los servicios de acceso de cliente en un servidor de buzones de correo: Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook | ?{$_.Name -like '*probe'}.

Para obtener más información sobre los sondeos y el marco de supervisión, vea Disponibilidad administrada, Disponibilidad administrada y estado del servidor y Personalización de la disponibilidad administrada.

De forma predeterminada, el cmdlet usa la cuenta de supervisión de pruebas adjunta al sondeo especificado. Puede escribir un buzón distinto en su lugar, mediante el parámetro MailboxId. A continuación encontrará opciones y resultados.

  • No se especifican MailboxId ni Credential: prueba de conectividad genérica en un buzón de prueba con las credenciales de prueba del sistema.
  • Se especifica MailboxId, Credential is not: Connectivity test to the specific mailbox using the system's test credentials.
  • Se especifica MailboxId y Credential: Se realiza una prueba de conectividad en el buzón específico y, además, se comprueba que las credenciales suministradas son válidas para ese buzón

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-OutlookConnectivity -ProbeIdentity OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe

En Exchange 2013 o posterior, en este ejemplo se ejecuta una mapi a través de HTTP OutlookRpcSelfTestProbe en el servidor de buzones al que está conectado actualmente.

Ejemplo 2

Test-OutlookConnectivity "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 1234512345" -RunFromServerId PrimaryMailbox -MailboxId johnd@contoso.com

En Exchange 2013 o posterior, en este ejemplo se ejecuta OutlookRpcDeepTestProbe desde el servidor "PrimaryMailbox" del buzón "johnd@contoso.com" montado en "Mailbox Database 1234512345". Puesto que no se ha especificado el parámetro Credential, el sondeo utilizará las credenciales de comprobación predeterminadas.

Ejemplo 3

Test-OutlookConnectivity -Protocol HTTP -GetDefaultsFromAutoDiscover $true

En Exchange 2010, este ejemplo prueba el escenario de conectividad de Outlook de un extremo a otro más común para Outlook anywhere. Esto incluye pruebas de conectividad a través del servicio Detección automática, creación de un perfil de usuario e inicio de sesión en el buzón de usuario. Todos los valores necesarios se recuperan del servicio Detección automática. Dado que no se especifica el parámetro Identity, el comando usa el usuario de prueba temporal que ha creado mediante el script de New-TestCasConnectivityUser.ps1. Este comando de ejemplo se puede ejecutar para probar la conectividad TCP/IP estableciendo el parámetro Protocol en RPC.

Ejemplo 4

Test-OutlookConnectivity -RpcProxyTestType:Internal -RpcTestType:Server

En Exchange 2010, este ejemplo comprueba la conectividad de Outlook en cualquier lugar mediante el servidor local como punto de conexión RpcProxy, así como el punto de conexión RPC. Dado que no se especifica el parámetro Identity, el comando usa el usuario de prueba temporal que ha creado mediante el script de New-TestCasConnectivityUser.ps1. Modifique este ejemplo para usar la dirección URL externa pública estableciendo el parámetro RpcProxyTestType en Externo. Además, el comando de ejemplo puede usar la matriz del servidor de acceso de cliente como punto de conexión RPC estableciendo el parámetro RpcTestType en Matriz. Para validar solo la conectividad TCP/IP, omita el parámetro RpcProxyTestType.

Ejemplo 5

Test-OutlookConnectivity -RpcProxyServer RpcProxySrv01 -RpcProxyAuthenticationType Basic -RpcClientAccessServer CAS01 -RpcAuthenticationType NTLM

En Exchange 2010, este ejemplo valida la conectividad de Outlook a través de RpcProxy en un servidor a otro servidor que ejecuta el rol de servidor de acceso de cliente con Básico para la capa de autenticación externa y NTLM para la capa de autenticación interna. El uso de estos parámetros debe permitirle validar la mayoría de los tipos de configuraciones de conectividad de Outlook. Este comando también se puede usar con el parámetro GetDefaultsFromAutoDiscover establecido en $true si solo necesita invalidar uno o dos parámetros. Este comando siguiente es similar a ejecutar una prueba de conectividad mediante la utilidad RPC Ping, pero proporciona una validación más segura.

Parámetros

-Archive

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro Archive especifica si se deben realizar pruebas para conectarse al buzón de archivo local del usuario. Los valores admitidos son:

$true: conéctese al buzón de archivo local del usuario.

$false: no se conecte al buzón local del usuario. Este es el valor predeterminado.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Confirm

Este parámetro solo está disponible en Exchange Server 2010.

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

-Credential

El parámetro Credential especifica las credenciales que utiliza el sondeo. Las credenciales de prueba del sistema se usan de forma predeterminada

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 2013, Exchange Server 2016, Exchange Server 2019

-GetDefaultsFromAutodiscover

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro GetDefaultsFromAutodiscover especifica si se obtienen valores predeterminados para todos los demás parámetros del comando desde la configuración del servicio Detección automática. Si ejecuta el comando que especifica valores para otros parámetros, esos valores invalidan los valores predeterminados del servicio de detección automática. El valor predeterminado para este parámetro es $true.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Hostname

El parámetroHostname especifica el destino del punto de conexión de protocolo del sondeo. Puede usar un servidor de buzón de correo específico o enrutar a través del servidor del servicio de nombres distribuidos.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro Identity especifica un buzón de usuario de destino. 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 no usa este parámetro, el comando busca un usuario de prueba en Active Directory que creó anteriormente mediante el script de New-TestCasConnectivityUser.ps1.

Type:MailboxIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MailboxCredential

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro MailboxCredential especifica determinadas credenciales para permitir el acceso de inicio de sesión al buzón de un usuario. Use el parámetro junto con el parámetro Identity para acceder al buzón de un usuario cuando no tenga permisos de acceso.

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:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MailboxId

El parámetro MailboxID especifica el buzón de correo de destino.

En Exchange 2013 o posterior, el parámetro Identity especifica un buzón de usuario de destino. 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 no usa este parámetro, el comando usa la cuenta de prueba.

Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MonitoringContext

Este parámetro solo está disponible en Exchange Server 2010.

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

-ProbeIdentity

El parámetro ProbeIdentity especifica el sondeo que se utilizará. Los valores admitidos son:

Sondeos de Outlook En cualquier lugar (RPC a través de HTTP):

  • Outlook.Protocol\OutlookRpcSelfTestProbe: valida que el punto de conexión RPC/HTTP puede recibir tráfico en el servidor de buzones de correo. No intenta iniciar sesión en un buzón de correo. Es una comprobación de conectividad de alto nivel.
  • Outlook.Protocol\OutlookRpcDeepTestProbe: valida que el punto de conexión RPC/HTTP funciona en el servidor de buzones de correo. Intentará conectarse al buzón e iniciar sesión en él. Dado que no se especifica ninguna base de datos, intentará conectarse a la primera base de datos devuelta por el cmdlet Get-MailboxDatabase.
  • Outlook.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: valida que el punto de conexión RPC/HTTP funciona en el servidor de buzones de correo. Intentará conectarse e iniciar sesión en el buzón de la base de datos de buzones especificada. Si el nombre de la base de datos de buzón de correo contiene espacios, incluya todo el valor entre comillas (por ejemplo, "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530").

Sondeos MAPI a través de HTTP:

  • OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe: valida que el punto de conexión MAPI/HTTP puede recibir tráfico en el servidor de buzones de correo. No intenta iniciar sesión en un buzón de correo. Es una comprobación de conectividad de alto nivel.
  • OutlookMapiHttp.Protocol\OutlookMapiHttpDeepTestProbe: valida que el punto de conexión MAPI/HTTP funciona en el servidor de buzones de correo. Intentará conectarse e iniciar sesión en el buzón. Dado que no se especifica ninguna base de datos, intentará conectarse a la primera base de datos devuelta por el cmdlet Get-MailboxDatabase.
  • OutlookMapiHttp.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: valida que el punto de conexión MAPI/HTTP funciona en el servidor de buzones de correo. Intentará conectarse e iniciar sesión en el buzón de la base de datos especificada. Si el nombre de la base de datos de buzón de correo contiene espacios, incluya todo el valor entre comillas (por ejemplo, "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530").
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Protocol

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro Protocol especifica si se va a probar la conectividad de Outlook en cualquier lugar o si se va a probar directamente la conectividad RPC o TCP/IP. El valor es HTTP o TCP.

Type:Protocol
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcAuthenticationType

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro RpcAuthenticationType especifica la configuración de autenticación que se va a probar para la capa RPC. El uso de este parámetro es útil si se establece un tipo de autenticación diferente en el directorio virtual del proxy RPC. Puede usar los siguientes valores:

  • NTLM
  • Kerberos
  • Negociar

El valor predeterminado es Negotiate.

Type:RpcAuthenticationType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcClientAccessServer

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro RpcClientAccessServer especifica el servidor de destino con el rol de servidor acceso de cliente instalado que desea probar. Puede ser un nombre de dominio completo (FQDN) del servidor o un GUID.

Type:ClientAccessServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcProxyAuthenticationType

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro RpcProxyAuthenticationType especifica la configuración de autenticación para el punto de conexión del proxy RPC. El valor se puede especificar como Basic, NTLM o Negotiate. No hay ningún valor predeterminado a menos que se use con el parámetro GetDefaultsFromAutodiscover.

Type:RPCProxyAuthenticationType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcProxyServer

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro RpcProxyServer especifica si se debe establecer el servidor RpcProxy de destino para las pruebas. Este parámetro se puede usar cuando el servidor RpcProxy es diferente del servidor de acceso de cliente.

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcProxyTestType

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro RpcProxyTestType especifica a qué punto de conexión HTTP debe conectarse el comando. Los valores admitidos son:

  • Interno: hace referencia al nombre del equipo local (https://<localcomputername>por ejemplo, https://CAS01).
  • Externo: hace referencia a un espacio de nombres público (la dirección URL HTTP externa en el directorio virtual /rpc, por ejemplo, https://mail.contoso.com).
Type:RpcProxyTestType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RpcTestType

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro RpcTestType especifica qué tipo de punto de conexión RPC debe probar el comando. Los valores admitidos son:

  • Servidor: el comando usa el servidor local como punto de conexión RPC.
  • Matriz: el comando busca un objeto ClientAccessArray en el sitio de Active Directory local.
Type:RpcTestType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RunFromServerId

El parámetro RunFromServerID especifica el servidor en el que se debe ejecutar el sondeo.

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TimeOutSeconds

El parámetro TimeOutSeconds especifica el tiempo de espera en segundos que deberá transcurrir para dar el sondeo por finalizado. El valor predeterminado es de 30 segundos. Los dígitos se pueden introducir con o sin comillas. 10 o "10" funcionarán. En caso de error de entrada se volverá al valor predeterminado de 30 segundos.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TotalTimeoutInMinutes

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro TotalTimeoutInMinutes especifica el límite de tiempo, en minutos, para que el comando espere a los resultados de las pruebas antes de finalizar la solicitud. El valor predeterminado es de dos minutos.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-TrustAnySslCert

Este parámetro solo está disponible en Exchange Server 2010.

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

-WhatIf

Este parámetro solo está disponible en Exchange Server 2010.

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

-WSTestType

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro WSTestType especifica el tipo de servidores que desea incluir en la prueba de conectividad de Outlook. Puede usar los siguientes valores:

  • Desconocido (este es el valor predeterminado).
  • Interno
  • Externo
Type:VirtualDirectoryUriScope
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

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.