Test-Mailflow
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2010-02-16
La cmdlet Test-Mailflow permet de diagnostiquer s'il est possible d'échanger des messages avec succès avec la boîte aux lettres système sur un ordinateur sur lequel le rôle serveur de boîtes aux lettres est installé. 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.
Syntaxe
Test-Mailflow [-Identity <ServerIdParameter>] [-ActiveDirectoryTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]
Test-Mailflow [-Identity <ServerIdParameter>] -TargetMailboxServer <ServerIdParameter> [-ActiveDirectoryTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]
Test-Mailflow [-Identity <ServerIdParameter>] -TargetEmailAddress <String> [-ActiveDirectoryTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-TargetEmailAddressDisplayName <String>] [-WhatIf [<SwitchParameter>]]
Test-Mailflow [-Identity <ServerIdParameter>] -AutoDiscoverTargetMailboxServer <SwitchParameter> [-ActiveDirectoryTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]
Description détaillée
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. Cette cmdlet permet de vérifier que la boîte aux lettres système sur un serveur de boîtes aux lettres peut envoyer avec succès un message à la boîte aux lettres système sur un autre serveur de boîtes aux lettres.
Cette tâche exécutée manuellement permet d'obtenir des informations utiles pour l'administrateur. Il est également possible de l'appeler à l'aide d'outils de contrôle tels que Microsoft Operations Manager (MOM), Exchange Best Practices Analyzer et l'Assistant dépannage d'Exchange. Lorsque la tâche est appelée par MOM, des alertes sont générées pour indiquer des échecs ou des performances lentes.
La cmdlet Test-Mailflow permet d'effectuer un test local ou un test à distance. Si vous ne spécifiez pas de paramètres, un test local est effectué et le serveur s'envoie à lui-même un message de test. En sas de spécification du paramètre TargetEmailAddress, TargetMailboxServer ou AutoDiscoverTargetMailboxServer, un test a distance est effectué. Les paramètres TargetEmailAddress, TargetMailboxServer et AutoDiscoverTargetMailboxServer s'excluent mutuellement.
Pour tester la remise du courrier électronique dans un scénario inter-forêts, utilisez le paramètre TargetEmailAddress. Pour tester la remise du courrier électronique entre serveurs de boîtes aux lettres au sein d'une forêt Active Directory, utilisez le paramètre TargetMailboxServer. Pour peupler automatiquement la liste des serveurs cible sur lesquels tester le flux de messagerie, utilisez le paramètre AutoDiscoverTargetMailboxServer.
Si vous spécifiez plusieurs de ces paramètres, le paramètre AutoDiscoverTargetMailboxServer a la priorité sur les paramètres TargetEmailAddress et TargetMailboxServer. Le paramètre TargetMailboxServer a la priorité sur le paramètre TargetEmailAddress. En cas d'exécution d'un test local, le serveur local doit disposer d'une boîte aux lettres système pour chaque base de données de boîtes aux lettres. En cas d'exécution d'un test à distance, les serveurs sources et de destination doivent tous les deux disposer d'une boîte aux lettres système ou une boîte aux lettres spécifique doit être définie à l'aide de paramètres.
Pour exécuter la cmdlet Test-Mailflow, vous devez utiliser un compte auquel ont été délégués :
- le rôle Administrateur d'organisation Exchange et le groupe Administrateurs de domaine pour le serveur sur lequel la cmdlet est exécutée.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
AutoDiscoverTargetMailboxServer |
Obligatoire |
System.Management.Automation.SwitchParameter |
Le paramètre AutoDiscoverTargetMailboxServer renseigne automatiquement une liste de serveurs de boîtes aux lettres cibles auxquels envoyer un message de test. La tâche interroge le service d'annuaire Active Directory pour découvrir tous les serveurs de boîtes aux lettres, puis envoie un message de test à chaque serveur. |
TargetEmailAddress |
Obligatoire |
System.String |
Le paramètre TargetEmailAddress spécifie l'adresse SMTP de la boîte aux lettres à laquelle des 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. |
TargetMailboxServer |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Le paramètre TargetMailboxServer spécifie un ou plusieurs serveurs de boîtes aux lettres dans l'organisation Exchange locale auxquels des messages de test sont envoyés. |
ActiveDirectoryTimeout |
Facultatif |
System.Int32 |
La paramètre ActiveDirectoryTimeout spécifie le nombre secondes qui s'écoulent avant que la tâche envoie un message d'information à l'administrateur concernant le retard. La valeur par défaut est 15 secondes. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre Confirm suspend le traitement par la commande et demande à l'administrateur de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Le paramètre DomainController permet de spécifier le nom de domaine complet (FQDN) du contrôleur de domaine auquel cette commande lie et qui écrit cette modification dans Active Directory. |
ErrorLatency |
Facultatif |
System.Int32 |
Le paramètre ErrorLatency spécifie le temps d'attente pour la remise d'un message de test avant qu'un événement d'erreur soit journalisé dans MOM. La valeur par défaut en cas d'envoi d'un message de test au serveur de boîtes aux lettres local est de 15 secondes, et de 180 secondes en cas d'envoi d'un message de test à un serveur de boîtes aux lettres distant. |
ExecutionTimeout |
Facultatif |
System.Int32 |
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. Lors de l'exécution de la tâche dans l'environnement de ligne de commande Exchange Management Shell, le paramétrage par défaut est de 240 secondes. En cas d'utilisation du paramètre MonitoringContext, le paramétrage par défaut est de 15 secondes. |
Identity |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Le paramètre Identity spécifie le nom du serveur de boîtes aux lettres source à partir duquel un message de test est envoyé. La valeur par défaut est le serveur de boîtes aux lettres local. |
MonitoringContext |
Facultatif |
System.Boolean |
Le paramètre MonitoringContext n'est utilisé qu'en cas d'utilisation de MOM pour la surveillance du serveur. Si vous définissez la valeur sur |
TargetEmailAddressDisplayName |
Facultatif |
System.String |
Le paramètre TargetEmailAddressDisplayName spécifie le nom complet du serveur de boîtes aux lettres auquel les messages de test sont envoyés. |
WhatIf |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, l'administrateur peut afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est |
Types d'entrées
Types de retours
La cmdlet Test-Mailflow renvoie les propriétés suivantes pour vous aider à dépanner des problèmes de flux de messagerie :
MailFlowResult Cette propriété affiche soit Succès, soit Échec.
MessageLatencyTime Cette propriété affiche le temps en secondes qui a été nécessaire pour l'envoi d'un message de test au serveur de boîtes aux lettres destinataire.
IsRemoteTest Cette propriété indique si le message de test a été envoyé à un serveur autre que le serveur de boîtes aux lettres local ou à une adresse de messagerie.
Erreurs
| Erreur | Description |
|---|---|
|
Exceptions
| Exceptions | Description |
|---|---|
|
Exemple
Le premier exemple montre comment envoyer un message de test du serveur Mailbox1 au serveur Mailbox2.
Le deuxième exemple montre comment envoyer un message de test du serveur Mailbox1 à l'adresse de messagerie john@contoso.com. Dans cet exemple, le message de test est envoyé à un serveur de boîtes aux lettres dans une forêt distante.
Test-Mailflow Mailbox1 -TargetMailboxServer Mailbox2
Test-Mailflow Mailbox1 -TargetEmailAddress john@contoso.com