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.
Syntaxe
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
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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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. 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
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AutoDiscoverTargetMailboxServer
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AutoDiscoverTargetMailboxServer
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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-*) comportent 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CrossPremises
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Le paramètre CrossPremises spécifie si le test de flux de messagerie est effectué en mode intersite.
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.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
CrossPremises
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CrossPremisesExpirationTimeout
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | EnhancedTimeSpan |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
CrossPremises
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CrossPremisesPendingErrorCount
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
CrossPremises
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 ».
Propriétés du paramètre
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ErrorLatency
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExecutionTimeout
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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é.
Propriétés du paramètre
| Type: | ServerIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AutoDiscoverTargetMailboxServer
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
TargetDatabase
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
TargetEmailAddress
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
TargetMailboxServer
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
SourceServer
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-MonitoringContext
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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. Cette valeur est la valeur par défaut.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TargetDatabase
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | DatabaseIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
TargetDatabase
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TargetEmailAddress
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
TargetEmailAddress
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TargetEmailAddressDisplayName
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
TargetEmailAddress
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TargetMailboxServer
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | ServerIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
TargetMailboxServer
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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.