Konfigurieren von Get-QueueDigest

Gilt für: Exchange Server 2013

Mit dem Cmdlet Get-QueueDigest können Sie Informationen zu manchen oder allen Warteschlangen in Ihrer Exchange-Organisation mit nur einem einzigen Befehl anzeigen.

Standardmäßig sind die vom Cmdlet Get-QueueDigest zurückgegebenen Ergebnisse zwischen ein und zwei Minuten alt. Diese Werte werden durch die folgenden Einstellungen gesteuert:

  • QueueLoggingInterval-Schlüssel in EdgeTransport.exe.config: Dieser Schlüssel gibt an, wie häufig Warteschlangendaten protokolliert werden und für Get-QueueDigest verfügbar sind. Der Standardwert ist 00:01:00 (eine Minute). Um einen Wert anzugeben, geben Sie ihn als Zeitspanne ein: hh:mm:ss , wobei h = Stunden, m = Minuten und s = Sekunden ist. Dieser Schlüssel ist standardmäßig nicht in der Datei "EdgeTransport.exe.config" vorhanden.

  • QueueDiagnosticsAggregationInterval-Parameter für Set-TransportConfig: Dieser Parameter gibt an, wie häufig Warteschlangendaten zwischen Postfachservern freigegeben werden. Der Standardwert ist 00:01:00 (eine Minute). Um einen Wert anzugeben, geben Sie ihn als Zeitspanne ein: hh:mm:ss , wobei h = Stunden, m = Minuten und s = Sekunden ist.

Die Summe der Parameterwerte QueueLoggingInterval und QueueDiagnosticsAggregationInterval bestimmen das maximale Alter der von Get-QueueDigest zurückgegebenen Ergebnisse.

Außerdem gibt Get-QueueDigest Ergebnisse unterschiedlich basierend auf Typ und Status der Warteschlange zurück. Beispielsweise werden die folgenden Warteschlangen in den Ergebnissen angezeigt, solange sie mindestens eine Nachricht enthalten:

  • die Übermittlungswarteschlange, die Nicht-erreichbar-Warteschlange und die Warteschlange für nicht verarbeitbare Nachrichten (dauerhafte Warteschlange).

  • Zustellungswarteschlangen mit dem Status "Angehalten" (Warteschlangen, die von einem Administrator manuell angehalten wurden).

Standardmäßig werden Zustellungswarteschlangen mit dem Status "Aktiv", "Verbinden", "Bereit" und "Wiederholen" nur dann in den Ergebnissen zurückgegeben, wenn die Warteschlange mindestens 10 Nachrichten enthält. Dieser Wert wird über den Schlüssel QueueLoggingThreshold in der Datei "EdgeTransport.exe.config" gesteuert. Sie können einen kleineren oder größeren ganzzahligen Wert angeben. Dieser Schlüssel ist standardmäßig nicht in der Datei "EdgeTransport.exe.config" vorhanden.

Was sollten Sie wissen, bevor Sie beginnen?

  • Geschätzte Zeit bis zum Abschließen des Vorgangs: 15 Minuten

  • Informationen zu den benötigten Exchange-Berechtigungen für Set-TransportConfig in der Exchange-Verwaltungsshell finden Sie unter "Transportkonfiguration" im Thema Berechtigungen für den Nachrichtenfluss.

  • Exchange-Berechtigungen gelten nicht für Änderungen an der Datei "EdgeTransport.exe.config" und den Neustart des Microsoft Exchange-Transportdiensts. Diese Verfahren werden im Betriebssystem des Exchange Server-Computers ausgeführt.

  • Änderungen, die Sie an der Datei "EdgeTransport.exe.config" vornehmen, werden nach einem Neustart des Microsoft Exchange-Transportdiensts angewendet. Wenn Sie diesen Dienst neu starten, wird die Nachrichtenübermittlung auf dem Server zeitweise unterbrochen.

  • Alle benutzerdefinierten Einstellungen pro Server, die Sie in Exchange XML-Anwendungskonfigurationsdateien vornehmen, z. B. web.config Dateien auf Clientzugriffsservern oder die EdgeTransport.exe.config-Datei auf Postfachservern, werden überschrieben, wenn Sie ein kumulatives Exchange-Update (CU) installieren. Stellen Sie sicher, dass Sie diese Informationen speichern, damit Sie Ihren Server nach der Installation einfach neu konfigurieren können. Sie müssen diese Einstellungen nach der Installation eines Exchange CU erneut konfigurieren.

  • Änderungen, die Sie mithilfe von Set-TransportConfig vornehmen, wirken sich auf alle Postfachserver in Ihrer Organisation aus. Änderungen, die Sie an der Datei "EdgeTransport.exe.config" vornehmen, betreffen nur den lokalen Postfachserver.

  • Informationen zu Tastenkombinationen für die Verfahren in diesem Thema finden Sie unter Tastenkombinationen in der Exchange-Verwaltungskonsole.

Tipp

Liegt ein Problem vor? Bitten Sie in den Exchange-Foren um Hilfe. Besuchen Sie die Foren auf Exchange Server.

Konfigurieren von Get-QueueDigest

  1. Geben Sie in einem Eingabeaufforderungsfenster den folgenden Befehl ein, um die Datei "EdgeTransport.exe.config" in Notepad zu öffnen:

    Notepad %ExchangeInstallPath%Bin\EdgeTransport.exe.config
    
  2. Fügen Sie einen oder beide der folgenden Schlüssel im <appSettings> Abschnitt hinzu.

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

    Um beispielsweise den Wert von QueueLoggingThreshold auf 1 einzustellen und den Wert von QueueLoggingInterval auf 30 Sekunden, verwenden Sie die folgenden Angaben:

    <add key="QueueLoggingThreshold" value="1" />
    <add key="QueueLoggingInterval" value="00:00:30" />
    
  3. Speichern und schließen Sie die Datei "EdgeTransport.exe.config" nach Abschluss des Vorgangs.

  4. Starten Sie den Microsoft Exchange-Transportdienst neu, indem Sie folgenden Befehl ausführen:

    net stop MSExchangeTransport && net start MSExchangeTransport
    
  5. Verwenden Sie die folgende Syntax, um den Wert des Parameters QueueDiagnosticsAggregationInterval in der Exchange-Verwaltungsshell zu ändern:

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

    Führen Sie beispielsweise den folgenden Befehl aus, um den Wert auf 30 Sekunden zu ändern:

    Set-TransportConfig -QueueDiagnosticsAggregationInterval 00:00:30
    

Woher wissen Sie, dass dieses Verfahren erfolgreich war?

Gehen Sie folgendermaßen vor, um sicherzustellen, dass Sie Get-QueueDigest erfolgreich konfiguriert haben:

  1. Überprüfen Sie die Werte der Schlüssel QueueLoggingThreshold und QueueLoggingInterval in der Datei "EdgeTransport.exe.config". Wenn die Schlüssel nicht vorhanden sind, werden die Standardwerte verwendet.

  2. Überprüfen Sie den Wert des Parameters QueueDiagnosticsAggregationInterval , indem Sie den folgenden Befehl ausführen:

    Get-TransportConfig | Format-List *queue*