Test-MAPIConnectivity
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean 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.
Syntax
Test-MAPIConnectivity
-Database <DatabaseIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-AllConnectionsTimeout <Int32>]
[-Confirm]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-PerConnectionTimeout <Int32>]
[-WhatIf]
[<CommonParameters>]Test-MAPIConnectivity
[-Identity] <MailboxIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-AllConnectionsTimeout <Int32>]
[-Archive]
[-Confirm]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-PerConnectionTimeout <Int32>]
[-WhatIf]
[<CommonParameters>]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.
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: 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.
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-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, permitido para que cada operación de Active Directory se complete antes de que se agote el tiempo de espera de la operación. El valor predeterminado es 15 segundos.
| Type: | Int32 |
| 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 |
-AllConnectionsTimeout
Este parámetro solo está disponible en Exchange local.
El parámetro AllConnectionsTimeout especifica la cantidad de tiempo, en segundos, permitido para que todas las conexiones se completen antes de que el cmdlet agote el tiempo de espera. La cuenta atrás de tiempo de espera no comienza hasta que se recopila toda la información necesaria para realizar las conexiones desde Active Directory.El valor predeterminado es 90 segundos.
| Type: | Int32 |
| 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 |
-Archive
El modificador Archive especifica si se va a 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 probará el buzón principal.
| 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, Exchange Online |
-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, Exchange Online |
-CopyOnServer
Este parámetro solo está disponible en Exchange local.
El parámetro CopyOnServer especifica el servidor de buzones que contiene la copia de 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 usar este parámetro con el parámetro Server, no con los parámetros Identify o Database.
| 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 |
-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 o el parámetro Identity, el comando prueba SystemMailbox en cada base de datos activa del servidor Exchange (el servidor de Exchange local o el servidor que especifique con el parámetro Server).
No puede usar los parámetros Identity, Database o Server en el mismo comando.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 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.
| 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 |
-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 cmdlet Get-Mailbox o Get-Recipient. Si canaliza la identificación desde los cmdlets Get-Mailbox o Get-Recipient, no es necesario usar este parámetro.
Si no usa este parámetro, el cmdlet prueba SystemMailbox en la base de datos que especifique.
No puede usar los parámetros Identity, Database o Server en el mismo comando.
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 prueba la conectividad MAPI desde la base de datos activa solo copia.
| Type: | SwitchParameter |
| 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 |
-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, 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).
- $false: Los eventos de supervisión y los contadores de rendimiento no se incluyen en los resultados del comando. 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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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.
| Type: | Int32 |
| 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 |
-Server
Este parámetro solo está disponible en Exchange local.
El parámetro Server indica el servidor en el que comprobará 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, Database o Server en el mismo comando.
| Type: | ServerIdParameter |
| Position: | Named |
| 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 |
-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, Exchange Online |
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