Partager via


Configurer Get-QueueDigest

S’applique à : Exchange Server 2013

La cmdlet Get-QueueDigest vous permet d'afficher des informations concernant une partie ou la totalité des files d'attente au sein de votre organisation Exchange à l'aide d'une seule commande.

Par défaut, les résultats renvoyés par la cmdlet Get-QueueDigest datent d'une à deux minutes. Ces valeurs sont contrôlées par les paramètres suivants :

  • Clé QueueLoggingInterval dans EdgeTransport.exe.config: cette clé spécifie la fréquence à laquelle les données de file d’attente sont journalisées et sont disponibles pour Get-QueueDigest. La valeur par défaut est 00:01:00 (une minute). Pour spécifier une valeur, entrez-la sous la forme d’un intervalle de temps : hh:mm:ssh = heures, m = minutes et s = secondes. Par défaut, cette clé n'est pas présente dans le fichier EdgeTransport.exe.config.

  • Paramètre QueueDiagnosticsAggregationInterval sur Set-TransportConfig : ce paramètre spécifie la fréquence à laquelle les données de file d’attente sont partagées entre les serveurs de boîtes aux lettres. La valeur par défaut est 00:01:00 (une minute). Pour spécifier une valeur, entrez-la sous la forme d’un intervalle de temps : hh:mm:ssh = heures, m = minutes et s = secondes.

La somme des valeurs de la clé QueueLoggingInterval et du paramètre QueueDiagnosticsAggregationInterval détermine l’âge maximal des résultats retournés par Get-QueueDigest.

En outre, Get-QueueDigest renvoie des résultats différemment en fonction du type de file d'attente et de l'état de la file d'attente. Par exemple, les files d'attente suivantes sont affichées dans les résultats tant qu'elles contiennent au moins un message :

  • la file d'attente de soumission, la file d'attente inaccessible et la file d'attente des messages incohérents (files d'attente permanentes) ;

  • les files d'attente de remise ayant l'état suspendu (files d'attente suspendues manuellement par un administrateur).

Par défaut, les files d'attente de remise ayant l'état Actif, Connexion, Prêt ou Nouvelle tentative sont renvoyées dans les résultats seulement si elles contiennent au moins 10 messages. Cette valeur est contrôlée par la clé QueueLoggingThreshold dans le fichier EdgeTransport.exe.config. Vous pouvez spécifier une valeur entière inférieure ou supérieure. Par défaut, cette clé n’est pas présente dans le fichier EdgeTransport.exe.config.

Ce qu’il faut savoir avant de commencer

  • Durée d'exécution estimée : 15 minutes

  • Pour voir les autorisations Exchange dont vous avez besoin pour exécuter Set-TransportConfig dans l'environnement de ligne de commande Exchange Management Shell, consultez l'entrée « Configuration du transport » dans la rubrique Autorisations de flux de messagerie.

  • Les autorisations Exchange ne s'appliquent pas à la modification du fichier EdgeTransport.exe.config et au redémarrage du service de transport Microsoft Exchange. Ces procédures sont exécutées dans le système d'exploitation du serveur Exchange.

  • Les modifications que vous enregistrez dans le fichier EdgeTransport.exe.config sont appliquées après le redémarrage du service de transport de Microsoft Exchange. Lorsque vous redémarrez le service, le flux de messagerie sur le serveur est temporairement interrompu.

  • Les paramètres par serveur personnalisés de vos fichiers de configuration d’application XML Exchange, par exemple les fichiers web.config sur les serveurs d’accès au client ou le fichier EdgeTransport.exe.config sur les serveurs de boîtes aux lettres, seront remplacés lors de l’installation d’une mise à jour cumulative Exchange. Veuillez enregistrer ces informations pour configurer à nouveau votre serveur après l’installation. Vous devez reconfigurer ces paramètres après avoir installé une mise à jour cumulative Exchange.

  • Les modifications apportées à l'aide de Set-TransportConfig affectent tous les serveurs de boîtes aux lettres dans votre organisation. Les modifications que vous apportez au fichier EdgeTransport.exe.config affectent uniquement le serveur de boîtes aux lettres local.

  • Pour des informations sur les raccourcis clavier applicables aux procédures de cette rubrique, voir Raccourcis clavier dans Exchange 2013Raccourcis clavier dans le Centre d'administration Exchange.

Conseil

Vous rencontrez des difficultés ? Demandez de l’aide en participant aux forums Exchange. Visitez les forums de Exchange Server.

Configurer Get-QueueDigest

  1. Dans une fenêtre d’invite de commandes, ouvrez le fichier EdgeTransport.exe.config dans le Bloc-notes en exécutant la commande suivante :

    Notepad %ExchangeInstallPath%Bin\EdgeTransport.exe.config
    
  2. Ajoutez une ou les deux clés suivantes dans la <appSettings> section .

    <add key="QueueLoggingThreshold" value="<integer>" />
    <add key="QueueLoggingInterval" value="<hh:mm:ss>" />
    

    Par exemple, pour définir la valeur de QueueLoggingThreshold sur 1 et la valeur de QueueLoggingInterval sur 30 secondes, utilisez les valeurs suivantes :

    <add key="QueueLoggingThreshold" value="1" />
    <add key="QueueLoggingInterval" value="00:00:30" />
    
  3. Lorsque vous avez terminé, enregistrez et fermez le fichier EdgeTransport.exe.config.

  4. Redémarrez le service de transport Microsoft Exchange en exécutant la commande suivante :

    net stop MSExchangeTransport && net start MSExchangeTransport
    
  5. Pour modifier la valeur du paramètre QueueDiagnosticsAggregationInterval dans Exchange Management Shell, utilisez la syntaxe suivante :

    Set-TransportConfig -QueueDiagnosticsAggregationInterval <hh:mm:ss>
    

    Par exemple, pour modifier la valeur sur 30 secondes, exécutez la commande suivante :

    Set-TransportConfig -QueueDiagnosticsAggregationInterval 00:00:30
    

Comment savoir si cela a fonctionné ?

Pour vérifier que vous avez correctement configuré Get-QueueDigest, procédez comme suit :

  1. Vérifiez les valeurs des clés QueueLoggingThreshold et QueueLoggingInterval dans le fichier EdgeTransport.exe.config. Si les clés ne sont pas présentes, les valeurs par défaut sont utilisées.

  2. Vérifiez la valeur du paramètre QueueDiagnosticsAggregationInterval en exécutant la commande suivante :

    Get-TransportConfig | Format-List *queue*