Test-Mailflow
Este cmdlet solo está disponible en el entorno local de Exchange.
Use el cmdlet Test-Mailflow para diagnosticar si el correo se puede enviar y entregar correctamente desde el buzón del sistema de un servidor de buzones. También puede usar este cmdlet para comprobar que el correo electrónico se envíe entre los servidores de buzones dentro de un umbral de latencia definido.
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-Mailflow
[[-Identity] <ServerIdParameter>]
[-AutoDiscoverTargetMailboxServer]
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]Test-Mailflow
-CrossPremises <Boolean>
[-ActiveDirectoryTimeout <Int32>]
[-CrossPremisesExpirationTimeout <EnhancedTimeSpan>]
[-CrossPremisesPendingErrorCount <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]Test-Mailflow
[[-Identity] <ServerIdParameter>]
-TargetDatabase <DatabaseIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]Test-Mailflow
[[-Identity] <ServerIdParameter>]
-TargetEmailAddress <String>
[-TargetEmailAddressDisplayName <String>]
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]Test-Mailflow
[[-Identity] <ServerIdParameter>]
-TargetMailboxServer <ServerIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]Test-Mailflow
[[-Identity] <ServerIdParameter>]
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]Description
El cmdlet Test-Mailflow prueba el envío, el transporte y la entrega de correo. El cmdlet comprueba que cada servidor de buzones pueda enviarse a sí mismo un mensaje correctamente. También puede usar este cmdlet para comprobar que el buzón del sistema en un servidor de buzones pueda enviar un mensaje correctamente al buzón del sistema de otro servidor de buzones. Se necesita un buzón del sistema en todos los servidores que participen en la prueba.
Los mensajes de prueba están disponibles en el buzón del sistema o del usuario de destino. El asunto del mensaje es Test-Mailflow <GUID>y el cuerpo del mensaje contiene el texto This is a Test-Mailflow probe message.
Los resultados de Test-Mailflow se muestran en pantalla. Estos son los valores interesantes de los resultados:
- TestMailflowResult: los valores devueltos suelen ser Correcto o *FAILURE*.
- MessageLatencyTime: tiempo necesario para completar la prueba (entregar el mensaje de prueba). El valor usa la sintaxis hh:mm:ss.ffff, donde hh = horas, mm = minutos, ss = segundos, y ffff = fracciones de segundo.
Puede escribir los resultados de Test-Mailflow en un archivo canalizando la salida a ConvertTo-Html o ConvertTo-Csv y agregando > <filename> al comando . Por ejemplo: Test-Mailflow -AutoDiscoverTargetMailboxServer | ConvertTo-Csv > "C:\My Documents\test-mailflow 2020-05-01.csv".
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-Mailflow Mailbox1 -TargetMailboxServer Mailbox2En este ejemplo se comprueba el flujo de mensajes del servidor de nombre Buzón1 al servidor de nombre Buzón2. Tenga en cuenta que tiene que ejecutar este comando mientras esté conectado a Buzón1.
Ejemplo 2
Test-Mailflow -TargetEmailAddress john@contoso.comEn este ejemplo se prueba el flujo de mensajes desde el servidor de buzones local donde se ejecuta este comando a la dirección john@contoso.comde correo electrónico .
Parámetros
-ActiveDirectoryTimeout
El parámetro ActiveDirectoryTimeout especifica la cantidad de segundos que transcurrirán antes de que la tarea proporcione un mensaje informativo sobre el retraso. 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 |
-AutoDiscoverTargetMailboxServer
El modificador AutoDiscoverTargetMailboxServer especifica si se rellena automáticamente una lista de servidores de buzones de destino a los que se envía un mensaje de prueba. No es necesario especificar un valor con este modificador.
La tarea consulta Active Directory para detectar todos los servidores de buzones de correo y, a continuación, envía a cada servidor un mensaje de prueba.
Cuando use este modificador, no podrá usar los parámetros CrossPremises, TargetDatabase, TargetEmailAddress ni TargetMailboxServer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| 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 |
-CrossPremises
El parámetro CrossPremises especifica si la prueba del flujo de correo se realizará en el modo entre instalaciones.
Establezca este parámetro en $true si su organización usa una implementación entre instalaciones y desea comprobar el flujo de correo entre instalaciones.
Cuando use este parámetro, no podrá usar los parámetros AutoDiscoverTargetMailboxServer, TargetDatabase, TargetEmailAddress ni TargetMailboxServer.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-CrossPremisesExpirationTimeout
El parámetro CrossPremisesExpirationTimeout se usa cuando los agentes de Microsoft System Center Operations Manager 2007 ejecutan este cmdlet para la supervisión asincrónica. No se recomienda usar este parámetro cuando se ejecuta este cmdlet manualmente.
| Type: | EnhancedTimeSpan |
| 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 |
-CrossPremisesPendingErrorCount
El parámetro CrossPremisesPendingErrorCount se usa cuando los agentes de System Center Operations Manager 2007 ejecutan este cmdlet para la supervisión asincrónica. No se recomienda usar este parámetro cuando se ejecuta este cmdlet manualmente.
| 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 |
-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 |
-ErrorLatency
El parámetro ErrorLatency especifica el tiempo que se debe esperar para que un mensaje de prueba se entregue antes de registrar un evento de error en Microsoft System Center Operations Manager 2007. El valor predeterminado cuando se envía un mensaje de prueba al servidor de buzones local es de 15 segundos, y 180 segundos cuando se envía un mensaje de prueba a un servidor de buzones remoto.
| 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 |
-ExecutionTimeout
El parámetro ExecutionTimeout especifica el tiempo máximo que se puede ejecutar esta tarea antes de que se determine que la prueba presenta un error. Si no se recibe un mensaje de prueba ni un informe de entrega antes de que expire este tiempo, la tarea finaliza y se envía un error. Cuando la tarea se ejecuta en el Shell de administración de Exchange, la configuración predeterminada es de 240 segundos. Cuando se usa el parámetro MonitoringContext, 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 |
-Identity
El parámetro Identity especifica el nombre del servidor de buzones de origen desde el que se envía un mensaje de prueba. 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 usa este parámetro, se usa el servidor de buzones local.
| 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 |
-MonitoringContext
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 |
-TargetDatabase
El parámetro TargetDatabase especifica la base de datos de buzones a la que se envían los mensajes de prueba. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
No se puede usar este parámetro con los parámetros AutoDiscoverTargetMailboxServer, CrossPremises, TargetEmailAddress o TargetMailboxServer.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TargetEmailAddress
El parámetro TargetEmailAddress especifica la dirección SMTP del buzón a la que se envían los mensajes de prueba. Use este parámetro para enviar mensajes de prueba a un servidor de buzones en un bosque remoto. Si se usa este parámetro, la prueba siempre es remota.
Cuando use este parámetro, no podrá usar los parámetros AutoDiscoverTargetMailboxServer, CrossPremises, TargetDatabase ni TargetMailboxServer.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TargetEmailAddressDisplayName
El parámetro TargetEmailAddressDisplayName especifica un nombre para mostrar personalizado que se usa en eventos e informes de Microsoft System Center Operations Manager 2007 cuando se usa el parámetro TargetEmailAddress. Si no usa el parámetro TargetEmailAddressDisplayName, los eventos y los informes usarán el valor de dirección de correo electrónico especificado por el parámetro TargetEmailAddress.
Este parámetro solo está disponible con el parámetro TargetEmailAddress y no tiene ningún efecto en la salida del cmdlet fuera de Microsoft System Center Operations Manager.
| 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 |
-TargetMailboxServer
El parámetro TargetMailboxServer especifica uno o varios servidores de buzones de la organización local de Exchange a los que enviar mensajes de prueba. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:
- Name
- FQDN
- Distinguished name (DN)
- Nombre distintivo (DN) heredado de Exchange
Cuando use este parámetro, no podrá usar los parámetros AutoDiscoverTargetMailboxServer, CrossPremises, TargetDatabase ni TargetEmailAddress.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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.