Test-Mailflow

La cmdlet est disponible uniquement dans Exchange en local.

La cmdlet Test-Mailflow permet de diagnostiquer si le courrier peut être correctement échangé depuis la boîte aux lettres système sur un serveur de boîtes aux lettres. Cette cmdlet permet également de vérifier que des messages électroniques sont échangés entre des serveurs de boîtes aux lettres dans le respect d’un seuil de latence défini.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet 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

La cmdlet Test-Mailflow teste le dépôt, le transport et la remise des messages. La cmdlet vérifie que chaque serveur de boîtes aux lettres peut s’envoyer à lui-même un message avec succès. Vous pouvez également utiliser cette cmdlet pour vérifier que la boîte aux lettres système d’un serveur de boîtes aux lettres peut correctement envoyer un message à la boîte aux lettres système sur un autre serveur de boîtes aux lettres. Une boîte aux lettres système est nécessaire sur tous les serveurs impliqués dans le test.

Les messages de test sont disponibles dans la boîte aux lettres utilisateur ou système cible. L’objet du message est Test-Mailflow <GUID>, et le corps du message contient le texte This is a Test-Mailflow probe message.

Les résultats de Test-Mailflow s’affichent à l’écran. Dans ces résultats, les valeurs intéressantes sont :

  • TestMailflowResult : les valeurs retournées sont généralement Réussite ou *ÉCHEC*.
  • MessageLatencyTime : temps nécessaire pour terminer le test (remettre le message de test). La valeur utilise la syntaxe hh:mm:ss.ffff où hh = heures, mm = minutes, ss = secondes et ffff = fractions de seconde.

Vous pouvez écrire les résultats Test-Mailflow dans un fichier en dirigeant la sortie vers ConvertTo-Html ou ConvertTo-Csv et en ajoutant > <filename> à la commande. Par exemple : Test-Mailflow -AutoDiscoverTargetMailboxServer | ConvertTo-Csv > "C:\My Documents\test-mailflow 2020-05-01.csv".

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Test-Mailflow Mailbox1 -TargetMailboxServer Mailbox2

Cet exemple teste le flux de messages du serveur nommé Mailbox1 au serveur nommé Mailbox2. Notez que vous devez exécuter cette commande lorsque vous êtes connecté à Mailbox1.

Exemple 2

Test-Mailflow -TargetEmailAddress john@contoso.com

Cet exemple teste le flux de messages du serveur de boîtes aux lettres local où vous exécutez cette commande vers l’adresse john@contoso.come-mail .

Paramètres

-ActiveDirectoryTimeout

Le paramètre ActiveDirectoryTimeout spécifie le nombre de secondes s’écoulant avant que la tâche fournisse un message d’information concernant le retard. La valeur par défaut est 15 secondes.

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

L’option AutoDiscoverTargetMailboxServer indique s’il faut remplir automatiquement la liste des serveurs de boîtes aux lettres cible auxquels envoyer un message de test. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

La tâche interroge Active Directory pour découvrir tous les serveurs de boîtes aux lettres, puis envoie un message de test à chaque serveur.

Lorsque vous utilisez cette option, vous ne pouvez pas utiliser les paramètres CrossPremises, TargetDatabase, TargetEmailAddress ou 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

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
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

Le paramètre CrossPremises spécifie si le test du flux de messagerie sera mené en mode inter-site.

Définissez ce paramètre sur $true si votre organisation procède à un déploiement inter-site et si vous souhaitez vérifier le flux de messagerie inter-site.

Lorsque vous utilisez ce paramètre, vous ne pouvez pas utiliser les paramètres AutoDiscoverTargetMailboxServer, TargetDatabase, TargetEmailAddress ou 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

Le paramètre CrossPremisesExpirationTimeout est utilisé lorsque des agents Microsoft System Center Operations Manager 2007 exécutent cette cmdlet à des fins d’analyse asynchrone. Nous déconseillons l’utilisation de ce paramètre pour toute exécution manuelle de cette cmdlet.

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

Le paramètre CrossPremisesPendingErrorCount est utilisé lorsque des agents Microsoft System Center Operations Manager 2007 exécutent cette cmdlet à des fins d’analyse asynchrone. Nous déconseillons l’utilisation de ce paramètre pour toute exécution manuelle de cette cmdlet.

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

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « 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

Le paramètre ErrorLatency spécifie combien de temps il convient d’attendre pour qu’un message de test soit remis avant qu’un événement d’erreur soit journalisé dans Microsoft System Center Operations Manager 2007. La valeur par défaut lorsqu’un message de test est envoyé au serveur de boîtes aux lettres local est de 15 secondes et de 180 secondes lorsqu’un message de test est envoyé à un serveur de boîtes aux lettres à distance.

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

Le paramètre ExecutionTimeout spécifie le temps maximal d’exécution de cette tâche avant que le résultat du test soit considéré comme un échec. Si aucun message de test ni état de remise n’arrive avant l’expiration de ce délai, la tâche est interrompue et une erreur est signalée. Lorsque la tâche est exécutée dans Exchange Management Shell, le paramètre par défaut est 240 secondes. En cas d’utilisation du paramètre MonitoringContext, le paramétrage par défaut est de 15 secondes.

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

Le paramètre Identity spécifie le nom du serveur de boîtes aux lettres source à partir duquel un message de test est envoyé. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

  • Nom
  • FQDN
  • Nom unique
  • DN Exchange hérité

Si vous n’utilisez pas ce paramètre, le serveur de boîtes aux lettres local est utilisé.

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

Le paramètre MonitoringContext spécifie s’il faut inclure les événements de contrôle associés et les compteurs de performance dans les résultats. Les valeurs valides sont les suivantes :

  • $true : les événements de surveillance et les compteurs de performances sont inclus dans les résultats de la commande. En règle générale, vous incluez les événements de surveillance et les compteurs de performances dans les résultats lorsque la sortie est passée à Microsoft System Center Operations Manager (SCOM).
  • $false : les événements de surveillance et les compteurs de performances ne sont pas inclus dans les résultats de la commande. Il s’agit de la valeur par défaut.
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

Le paramètre TargetDatabase spécifie la base de données de boîtes aux lettres vers laquelle les messages de test sont envoyés. Vous pouvez utiliser n’importe quelle valeur qui identifie la base de données de manière unique. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Vous ne pouvez pas utiliser ce paramètre avec les paramètres AutoDiscoverTargetMailboxServer, CrossPremises, TargetEmailAddress ou 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

Le paramètre TargetEmailAddress spécifie l’adresse SMTP de la boîte aux lettres vers laquelle les messages de test sont envoyés. Ce paramètre permet d’envoyer des messages de test à un serveur de boîtes aux lettres dans une forêt distante. En cas d’utilisation de ce paramètre, le test est toujours un test à distance.

Lorsque vous utilisez ce paramètre, vous ne pouvez pas utiliser les paramètres AutoDiscoverTargetMailboxServer, CrossPremises, TargetDatabase ou 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

Le paramètre TargetEmailAddressDisplayName spécifie un nom complet personnalisé, utilisé pour les événements et les rapports dans Microsoft System Center Operations Manager 2007, lorsque le paramètre TargetEmailAddress est utilisé. Si vous n’utilisez pas le paramètre TargetEmailAddressDisplayName, les événements et les rapports utilisent la valeur de l’adresse de messagerie spécifiée par le paramètre TargetEmailAddress.

Ce paramètre est disponible uniquement avec le paramètre TargetEmailAddress et n’a aucun effet sur la sortie de l’applet de commande en dehors 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

Le paramètre TargetMailboxServer spécifie un ou plusieurs serveurs de boîtes aux lettres dans la organization Exchange locale à laquelle envoyer des messages de test. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

  • Nom
  • FQDN
  • Nom unique
  • DN Exchange hérité

Lorsque vous utilisez ce paramètre, vous ne pouvez pas utiliser les paramètres AutoDiscoverTargetMailboxServer, CrossPremises, TargetDatabase ou 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

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.