Compartir a través de


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.

Sintaxis

AutoDiscoverTargetMailboxServer

Test-Mailflow
    [[-Identity] <ServerIdParameter>]
    [-AutoDiscoverTargetMailboxServer]
    [-ActiveDirectoryTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

CrossPremises

Test-Mailflow
    -CrossPremises <Boolean>
    [-ActiveDirectoryTimeout <Int32>]
    [-CrossPremisesExpirationTimeout <EnhancedTimeSpan>]
    [-CrossPremisesPendingErrorCount <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

TargetDatabase

Test-Mailflow
    [[-Identity] <ServerIdParameter>]
    -TargetDatabase <DatabaseIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

TargetEmailAddress

Test-Mailflow
    [[-Identity] <ServerIdParameter>]
    -TargetEmailAddress <String>
    [-TargetEmailAddressDisplayName <String>]
    [-ActiveDirectoryTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

TargetMailboxServer

Test-Mailflow
    [[-Identity] <ServerIdParameter>]
    -TargetMailboxServer <ServerIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

SourceServer

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 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 se le asignan. 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 Mailbox2

En este ejemplo se comprueba el flujo de mensajes del servidor de nombre Buzón1 al servidor de nombre Buzón2. Debe ejecutar este comando mientras está conectado a Mailbox1.

Ejemplo 2

Test-Mailflow -TargetEmailAddress john@contoso.com

En 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

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

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

-AutoDiscoverTargetMailboxServer

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-Confirm

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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

-CrossPremises

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

El parámetro CrossPremises especifica si la prueba de flujo de correo se realiza en modo entre locales.

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.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-CrossPremisesExpirationTimeout

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Propiedades del parámetro

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

Conjuntos de parámetros

CrossPremises
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

-CrossPremisesPendingErrorCount

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Propiedades del parámetro

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

Conjuntos de parámetros

CrossPremises
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

-DomainController

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

-ErrorLatency

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

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

-ExecutionTimeout

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

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

-Identity

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Propiedades del parámetro

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

Conjuntos de parámetros

AutoDiscoverTargetMailboxServer
Posición:1
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
TargetDatabase
Posición:1
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
TargetEmailAddress
Posición:1
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
TargetMailboxServer
Posición:1
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
SourceServer
Posición:1
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-MonitoringContext

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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 valor es el predeterminado.

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

-TargetDatabase

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-TargetEmailAddress

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-TargetEmailAddressDisplayName

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Propiedades del parámetro

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

Conjuntos de parámetros

TargetEmailAddress
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

-TargetMailboxServer

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-WhatIf

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

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