Get-AgentLog
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-06-28
Verwenden Sie das Cmdlet Get-AgentLog zum Analysieren von Protokolldateien, die Sie als Parameter angeben, und ermitteln Sie Rohstatistik während eines von Ihnen angegebenen Zeitraums aus den Filtern, die Agents zum Schutz vor unerwünschten Werbe-E-Mails anwenden.
Syntax
Get-AgentLog [-EndDate <DateTime>] [-Location <LocalLongFullPath>] [-StartDate <DateTime>]
Detaillierte Beschreibung
Damit Sie das Cmdlet Get-AgentLog ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- Mitgliedschaft in der lokalen Gruppe Administratoren
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
EndDate |
Optional |
System.DateTime |
Dieser Parameter gibt Datum und Uhrzeit an, zu der Sie das Ermitteln der Statistik beenden möchten. Die Standarduhrzeit ist die aktuelle Uhrzeit. Verwenden Sie bei Eingabe eines bestimmten Datums das kurze Datumsformat entsprechend den unter Regionale Einstellungen auf dem lokalen Computer konfigurierten Konventionen. Wenn Ihr Computer zum Verwenden des kurzen Datumsformats TT.MM.JJJJ konfiguriert ist, geben Sie für den 1. März 2006 Folgendes ein: 01.03.2006. Sie können einfach das Datum eingeben, z. B. |
Location |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
Der Parameter Location gibt das Verzeichnis an, das die Protokolldateien enthält, die Sie zum Erstellen von Verwendungsberichten verwenden können. Der Standardpfad lautet "C:\Programme\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog". Sie müssen den Dateipfad wie folgt bei der Eingabe in doppelte Anführungszeichen einschließen. Beispiel: |
StartDate |
Optional |
System.DateTime |
Der Parameter StartDate gibt das Datum und die Uhrzeit an, zu der das Ermitteln der Statistik gestartet wird. Die Standarduhrzeit ist die aktuelle Uhrzeit. Verwenden Sie bei Eingabe eines bestimmten Datums das kurze Datumsformat entsprechend den unter Regionale Einstellungen auf dem lokalen Computer konfigurierten Konventionen. Beispiel: Wenn Ihr Computer für die Verwendung des kurzen Datumsformats MM.TT.JJJJ konfiguriert ist, geben Sie 03.01.2006 ein, um den 1. März 2006 anzugeben. Sie können beispielsweise nur das Datum eingeben, wie etwa |
Rückgabetypen
| Objekt | Beschreibung |
|---|---|
Timestamp |
Die Uhrzeit des Protokolleintrags. |
ConnectorName |
CN des Connectors, der die Nachricht empfangen hat. |
SessionId |
Die IP-Adresse der SMTP-Sitzung. |
IPAddress |
Die IP-Adresse des die Verbindung herstellenden Servers. |
MessageId |
Die Nachrichten-ID von Microsoft Exchange Server 2007. |
P1FromAddress |
Das P1-Feld "Von:" der Nachrichtenkopfzeile (Nachrichtenumschlag) |
P2FromAddresses |
Das P2-Feld "Von:" der Nachrichtenkopfzeile (Nachrichtenumschlag) |
Recipients |
Die Nachrichtenempfänger. |
Agent |
Der Name des Agents, der die Aktion aufruft. |
Event |
Das Ereignis, für das die Aktion durchgeführt wurde. |
Action |
Die ausgeführte Aktion (ganze Zahl). |
SmtpResponse |
Die Antwort, die ggf. an den Aufrufer gesendet wird. |
Reason |
Der Begründungscode, der vom Agent bereitgestellt wird. |
ReasonData |
Ausführliche Beschreibung durch den Agent. |
Beispiel
Das folgende Codebeispiel gibt einen Bericht zurück, der die Statistik enthält, die am 5. Oktober 2005 ab 17:00 Uhr bis zur aktuellen Uhrzeit ermittelt wurde.
Get-AgentLog -StartDate "10/05/2005 5:00:00 PM"