Test-MAPIConnectivity

Módulo:: Exchange PowerShell

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser exclusivos de un entorno u otro.

Utilice el cmdlet Test-MapiConnectivity para comprobar la funcionalidad del servidor iniciando sesión en el buzón que indique. Si no especifica ningún buzón, el cmdlet iniciará la sesión en SystemMailbox, en la base de datos que especifique.

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

Database

Test-MAPIConnectivity
    -Database <DatabaseIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Confirm]
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Identity

Test-MAPIConnectivity
    [-Identity] <MailboxIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Archive]
    [-Confirm]
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Server

Test-MAPIConnectivity
    [-Server <ServerIdParameter>]
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IncludePassive]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Description

Use el cmdlet Test-MapiConnectivity para comprobar la funcionalidad del servidor. Este cmdlet inicia la sesión en el buzón que especifique (o en SystemMailbox si no especifica el parámetro Identity) y recupera una lista de elementos de la Bandeja de entrada. Al iniciar la sesión en los buzones, se comprueban dos protocolos críticos que se usan cuando un cliente se conecta a un servidor de buzón: MAPI y LDAP. Durante la autenticación, el cmdlet Test-MapiConnectivity comprueba indirectamente que el servidor MAPI, el almacén de Exchange y el Acceso al servicio de directorio (DSAccess) funcionan correctamente.

El cmdlet inicia sesión en el buzón que se especifique mediante las credenciales de la cuenta con la cual inició sesión en el equipo local. Tras una autenticación correcta, el cmdlet Test-MapiConnectivity obtiene acceso al buzón para comprobar que la base de datos funciona. Si se realiza una conexión correcta al buzón, el cmdlet también determina la hora a la que se produjo el intento de acceso.

Hay tres parámetros distintos que puede usar con el comando: Base de datos, Identidad y Servidor:

El parámetro Database toma la identidad de la misma y comprueba la posibilidad de obtener acceso al buzón del sistema en la base de datos indicada.
El parámetro Identity toma una identidad de buzón y comprueba la posibilidad de obtener acceso a un buzón determinado.
El parámetro Server toma la identidad de un servidor y comprueba la posibilidad de obtener acceso a todos los buzones del sistema del servidor indicado.

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 tiene asignados. 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-MapiConnectivity -Server "Server01"

En este ejemplo se comprueba la conectividad con el servidor Server01.

Ejemplo 2

Test-MapiConnectivity -Identity "midwest\john"

En este ejemplo se comprueba la conectividad con un buzón, especificado como nombre de dominio y nombre de usuario.

Parámetros

-ActiveDirectoryTimeout

Este parámetro solo está disponible en Exchange local.

El parámetro ActiveDirectoryTimeout especifica la cantidad de tiempo, en segundos, que se permite para que se complete cada operación de Active Directory antes de que se agote el tiempo de espera de la operación. El valor predeterminado es 15 segundos.

Propiedades de parámetro

Tipo:	Int32
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

-AllConnectionsTimeout

Este parámetro solo está disponible en Exchange local.

El parámetro AllConnectionsTimeout especifica la cantidad de tiempo, en segundos, permitida para que todas las conexiones se completen antes de que se agote el tiempo de espera del cmdlet. La cuenta atrás del tiempo de espera no comienza hasta que se recopila toda la información necesaria para realizar las conexiones de Active Directory. El valor predeterminado es 90 segundos.

Propiedades de parámetro

Tipo:	Int32
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

-Archive

El modificador de Archivo especifica si se debe probar la conectividad MAPI del archivo personal asociado al buzón especificado. No es necesario especificar un valor con este modificador.

Si no usa este modificador, solo se prueba el buzón principal.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Identity

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

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al 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. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.

Propiedades de 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

-CopyOnServer

Este parámetro solo está disponible en Exchange local.

El parámetro CopyOnServer especifica el servidor de buzones de correo que contiene la copia de la base de datos específica que se va a probar. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

Name
FQDN
Distinguished name (DN)
Nombre distintivo (DN) heredado de Exchange

Solo puede utilizar este parámetro con el parámetro Server, no con los parámetros Identificar o Base de datos.

Propiedades de parámetro

Tipo:	ServerIdParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Database

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

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

-Database

Este parámetro solo está disponible en Exchange local.

El parámetro Database indica la base de datos en la que se comprueba la conectividad al buzón del sistema. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:

Nombre
Nombre completo (DN)
GUID

Si no usa este parámetro ni el parámetro Identity, el comando comprueba el SystemMailbox en cada base de datos activa del servidor Exchange (el servidor Exchange local o el servidor que especifique con el parámetro Server).

No puede usar los parámetros Identity, Base de datos o Servidor en el mismo comando.

Propiedades de parámetro

Tipo:	DatabaseIdParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Database

Posición:	Named
Mandatory:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-DomainController

Este parámetro solo está disponible en Exchange local.

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 de 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

El parámetro Identity indica el buzón que se va a comprobar. 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)

Este cmdlet acepta la entrada de canalización del Get-Mailbox o Get-Recipient cmdlet. Si canaliza la identificación desde el Get-Mailbox o Get-Recipient cmdlets, no es necesario usar este parámetro.

Si no usa este parámetro, el cmdlet comprueba el SystemMailbox en la base de datos que especifique.

No puede usar los parámetros Identity, Base de datos o Servidor en el mismo comando.

Propiedades de parámetro

Tipo:	MailboxIdParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Identity

Posición:	1
Mandatory:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-IncludePassive

Este parámetro solo está disponible en Exchange local.

El modificador IncludePassive prueba la conectividad MAPI de todas las copias de base de datos activas y pasivas. No es necesario especificar un valor con este modificador.

Si no usa este modificador, el comando comprueba la conectividad MAPI solo de copias de bases de datos activas.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Server

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

Este parámetro solo está disponible en Exchange local.

El parámetro MonitoringContext especifica si en los resultados se incluyen o excluyen los eventos de supervisión y contadores de rendimiento asociados. Los valores admitidos son:

$true: Los eventos de supervisión y los contadores de rendimiento se incluyen en los resultados del comando. Normalmente, los eventos de supervisión y los contadores de rendimiento se incluyen en los resultados cuando la salida se pasa a Microsoft System Center Operations Manager (SCOM).
$false: Los eventos de supervisión y los contadores de rendimiento no se incluyen en los resultados del comando. Este valor es el predeterminado.

Propiedades de parámetro

Tipo:	Boolean
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

-PerConnectionTimeout

Este parámetro solo está disponible en Exchange local.

El parámetro PerConnectionTimeout indica el tiempo, en segundos, permitido para cada conexión antes de que finalice el tiempo de espera de la conexión. El valor predeterminado es 10 segundos.

Propiedades de parámetro

Tipo:	Int32
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

-Server

Este parámetro solo está disponible en Exchange local.

El parámetro Server especifica el servidor en el que se va a probar la conectividad MAPI. El comando comprobará la conectividad MAPI para cada buzón del sistema del servidor especificado. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

Name
FQDN
Distinguished name (DN)
Nombre distintivo (DN) heredado de Exchange

Si no especifica este parámetro, el comando comprueba el buzón en el servidor local.

No puede usar los parámetros Identity, Base de datos o Servidor en el mismo comando.

Propiedades de parámetro

Tipo:	ServerIdParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Server

Posición:	Named
Mandatory:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-WhatIf

El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.

Propiedades de 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.

Comentarios

¿Le ha resultado útil esta página?