Test-MapiConnectivity

  • Artículo

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2007-07-05

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.

Sintaxis

Test-MAPIConnectivity [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Database <DatabaseIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Identity <MailboxIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Para ejecutar el cmdlet Test-MapiConnectivity, deberá delegar a la cuenta que utilice los elementos siguientes:

  • Función de administrador de servidores de Exchange y grupo de administradores locales para el servidor de destino

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Utilice 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 utilizados 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 del servicio de directorio (DSAccess) funcionan.

El cmdlet inicia la sesión en el buzón que se especifique utilizando las credenciales de la cuenta con la cual ha iniciado la 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 diferentes que puede utilizar con el comando: Database, Identity y Server.

  • 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.

Parámetros

Parámetro Necesario Tipo Descripción

Database

Necesario

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

El parámetro Database indica la base de datos en la que se comprueba la conectividad al buzón del sistema. Si no especifica este parámetro o el parámetro Identity, el comando probará SystemMailbox en cada base de datos del servidor que se especifique, o en el servidor local si no se especifica el parámetro Server.

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

El parámetro Identity indica el buzón que se va a comprobar. Puede utilizar los siguientes valores:

  • GUID

  • Nombre completo (DN)

  • Domain\Account

  • Nombre principal de usuario (UPN)

  • DN de Exchange heredado

  • Dirección del Protocolo simple de transferencia de correo (SMTP)

  • Alias

  • Este parámetro acepta entrada de soporte desde del cmdlet Get-Mailbox o Get-Recipient Si un objeto se canaliza desde el cmdlet Get-Mailbox o Get-Recipient, este parámetro no es necesario.

  • Si no especifica este parámetro, el cmdlet probará SystemMailbox en la base de datos que especifique.

ActiveDirectoryTimeout

Opcional

System.Int32

El parámetro ActiveDirectoryTimeout indica el tiempo, en segundos, permitido para cada operación de Active Directory antes de que finalice el tiempo de espera de la operación. El valor predeterminado es 15 segundos.

AllConnectionsTimeout

Opcional

System.Int32

El parámetro ConnectionTimeout indica el tiempo, en segundos, permitido para realizar todas las conexiones antes de que finalice el tiempo de espera del cmdlet. El tiempo de espera no se empieza a contar hasta que se reúna toda la información necesaria para realizar las conexiones de Active Directory. El valor predeterminado es 90 segundos.

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

El parámetro DomainController indica el controlador de dominio que debe utilizarse para obtener acceso al servicio de directorio Active Directory. Utilice el nombre de dominio completo (FQDN) del controlador de dominio que desee utilizar.

MonitoringContext

Opcional

System.Boolean

El parámetro MonitoringContext indica si los resultados del comando incluirán eventos de supervisión y contadores de rendimiento. Los dos valores posibles para este parámetro son $true o $false. Si especifica $true, los resultados incluirán eventos de supervisión y contadores de rendimiento, además de la información acerca de la transacción MAPI.

PerConnectionTimeout

Opcional

System.Int32

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.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

El parámetro Server indica el servidor en el que comprobará la conectividad MAPI. El comando comprobará la conectividad MAPI a cada buzón del sistema del servidor indicado.

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

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

Excepciones

Excepciones Descripción

 

Ejemplo

El primer ejemplo comprueba la conectividad al servidor Server01.

El segundo ejemplo prueba la conectividad a un buzón, indicado como nombre de dominio y nombre de usuario.

Test-MapiConnectivity -Server "Server01"
Test-MapiConnectivity -Identity "midwest\john"