Get-AgentLog

  • Article

 

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, 10/05/2005. Vous pouvez également entrer la date et l'heure du jour. Si vous entrez une heure du jour et une date, vous devez placer l'argument entre guillemets, par exemple "10/05/2005 5:00:00 PM".

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, "C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog".

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, 10/05/2005, ou entrer la date et l'heure du jour. Si vous entrez une heure du jour et une date, vous devez placer l'argument entre guillemets, par exemple "10/05/2005 5:00:00 PM".

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"