Définit les propriétés de journal des événements qui limitent la taille du journal des événements et l'ancienneté de ses entrées.
Syntaxe
Limit-EventLog [-LogName] <string[]> [-ComputerName <string[]>] [-MaximumSize <Int64>] [-OverFlowAction {<OverwriteAsNeeded> | <OverwriteOlder> | <DoNotOverwrite>}] [-RetentionDays <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Limit-EventLog définit la taille maximale d'un journal des événements classique, la durée de conservation de chaque événement et l'action prévue lorsque le journal atteint sa taille maximale. Vous pouvez l'utiliser pour limiter les journaux des événements sur les ordinateurs locaux ou distants.
Les applets de commande contenant le nom EventLog (les applets de commande EventLog) fonctionnent uniquement sur les journaux des événements classiques. Pour obtenir des événements à partir des journaux qui utilisent la technologie Journal des événements Windows sous Windows Vista et les versions ultérieures de Windows, utilisez Get-WinEvent.
Paramètres
-ComputerName <string[]>
Spécifie un ordinateur distant. La valeur par défaut est l'ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou le nom de domaine complet d'un ordinateur distant. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.) ou « localhost ».
Ce paramètre ne s'appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName de Limit-EventLog même si votre ordinateur n'est pas configuré pour exécuter des commandes distantes.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
Local computer |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-LogName <string[]>
Spécifie les journaux des événements. Entrez le nom de journal (la valeur de la propriété Log et non LogDisplayName) d'un ou de plusieurs journaux des événements, en les séparant par des virgules. Les caractères génériques ne sont pas autorisés. Ce paramètre est obligatoire.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-MaximumSize <Int64>
Spécifie la taille maximale des journaux des événements (en octets). Entrez une valeur comprise entre 64 kilo-octets (Ko) et 4 gigaoctets (Go). La valeur doit être divisible par 64 Ko (65 536).
Ce paramètre spécifie la valeur de la propriété MaximumKilobytes de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-OverFlowAction <OverflowAction>
Spécifie l'action prévue lorsque le journal des événements atteint sa taille maximale.
Les valeurs valides sont :
-- DoNotOverwrite : les entrées existantes sont conservées et les nouvelles entrées sont ignorées.
-- OverwriteAsNeeded : chaque nouvelle entrée remplace l'entrée la plus ancienne.
-- OverwriteOlder : les nouveaux événements remplacent les événements antérieurs à la valeur spécifiée par la propriété MinimumRetentionDays. Si aucun événement n'est antérieur à la valeur spécifiée par la propriété MinimumRetentionDays, les nouveaux événements sont ignorés.
Ce paramètre spécifie la valeur de la propriété OverflowAction de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-RetentionDays <int>
Spécifie le nombre minimal de jours pendant lesquels un événement doit rester dans le journal des événements.
Ce paramètre spécifie la valeur de la propriété MinimumRetentionDays de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
None None |
|
Sorties |
None None |
Remarques
Pour utiliser Limit-EventLog sur Windows Vista et les versions ultérieures de Windows, ouvrez Windows PowerShell avec l'option Exécuter en tant qu'administrateur.
Limit-EventLog modifie les propriétés de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique. Pour consulter les paramètres actuels des propriétés de journal des événements, tapez « get-eventlog -list ».
Exemple 1
C:\PS>limit-eventLog -logname "Windows PowerShell" -MaximumSize 20KB Description ----------- Cette commande augmente la taille maximale du journal des événements Windows PowerShell sur l'ordinateur local jusqu'à 20 480 kilo-octets (Ko) (20 Mo).
Exemple 2
C:\PS>limit-eventlog -logname Security -comp Server01, Server02 -retentionDays 7 Description ----------- Grâce à cette commande, les événements qui figurent dans le journal de sécurité des ordinateurs Server01 et Server02 sont assurés d'être conservés pendant au moins 7 jours.
Exemple 3
C:\PS>$logs = get-eventlog -list | foreach {$_.log}
C:\PS> limit-eventlog -overflowaction OverwriteOlder -logname $logs
C:\PS> get-eventlog -list
Max(K) Retain OverflowAction Entries Log
------ ------ -------------- ------- ---
15,168 0 OverwriteOlder 3,412 Application
512 0 OverwriteOlder 0 DFS Replication
512 0 OverwriteOlder 17 DxStudio
10,240 7 OverwriteOlder 0 HardwareEvents
512 0 OverwriteOlder 0 Internet Explorer
512 0 OverwriteOlder 0 Key Management Service
16,384 0 OverwriteOlder 4 ODiag
16,384 0 OverwriteOlder 389 OSession
Security
15,168 0 OverwriteOlder 19,360 System
15,360 0 OverwriteOlder 15,828 Windows PowerShell
Description
-----------
Ces commandes modifient l'action de dépassement de capacité de tous les journaux des événements sur l'ordinateur local en « OverwriteOlder ».
La première commande obtient le nom de tous les journaux présents sur l'ordinateur local. La deuxième commande définit l'action de dépassement de capacité. La troisième commande affiche les résultats.
Voir aussi