Get-AgentLog
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-06-28
La cmdlet Get-AgentLog permet d'analyser les fichiers journaux que vous spécifiez comme paramètres et de collecter des statistiques brutes à partir du filtrage que les agents de blocage du courrier indésirable appliquent durant une période que vous spécifiez.
Syntaxe
Get-AgentLog [-EndDate <DateTime>] [-Location <LocalLongFullPath>] [-StartDate <DateTime>]
Description détaillée
Pour exécuter la cmdlet Get-AgentLog, vous devez utiliser un compte auquel a été délégué :
- l'appartenance au groupe Administrateurs local.
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 |
---|---|---|---|
EndDate |
Facultatif |
System.DateTime |
Ce paramètre spécifie la date et l'heure auxquelles vous voulez arrêter la collecte de statistiques. L'heure par défaut est l'heure actuelle. Si vous entrez une date spécifique, utilisez le format de date courte défini dans les paramètres Options régionales configurés sur l'ordinateur local. Par exemple, si votre ordinateur est configuré pour utiliser le format de date courte mm/jj/aaaa, entrez 03/01/2006 pour spécifier le 1er mars 2006. Vous pouvez entrer uniquement la date, par exemple, |
Location |
Facultatif |
Microsoft.Exchange.Data.LocalLongFullPath |
Le paramètre Location spécifie le répertoire contenant les fichiers journaux que vous pouvez utiliser pour créer des rapports d'utilisation. Par défaut, le chemin d'accès est C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog. Vous devez entrer le chemin d'accès entre guillemets, par exemple, |
StartDate |
Facultatif |
System.DateTime |
Le paramètre StartDate spécifie la date et l'heure auxquelles la collecte de statistiques commence. L'heure par défaut est l'heure actuelle. Si vous entrez une date spécifique, utilisez le format de date courte défini dans les paramètres Options régionales configurés sur l'ordinateur local. Par exemple, si l'ordinateur est configuré pour utiliser le format de date courte mm/jj/aaaa, entrez 03/01/2006 pour indiquer le 1er mars 2006. Vous pouvez entrer uniquement la date, par exemple, |
Types de retours
Objet | Description |
---|---|
Timestamp |
Heure d'entrée du journal |
ConnectorName |
Nom commun du connecteur ayant reçu le message |
SessionId |
Adresse IP de la session SMTP |
IPAddress |
Adresse IP du serveur de connexion |
MessageId |
ID du message Microsoft Exchange Server 2007 |
P1FromAddress |
Champ d'en-tête de message P1 (enveloppe de message) De : |
P2FromAddresses |
Champ d'en-tête de message P2 (en-tête du message) De : |
Recipients |
Destinataires du message |
Agent |
Nom de l'agent qui invoque l'action |
Event |
Événement ayant déclenché l'action |
Action |
Action exécutée (entier) |
SmtpResponse |
Réponse éventuelle envoyée à l'appelant |
Reason |
Code de raison fourni par l'agent |
ReasonData |
Description détaillée fournie par l'agent |
Exemple
L'exemple de code suivant retourne un rapport contenant les statistiques collectées entre 17h00, le 5 octobre 2005, et l'heure actuelle.
Get-AgentLog -StartDate "10/05/2005 5:00:00 PM"