Remove-Event

Article
01/13/2010

Supprime des événements de la file d'attente d'événements.

Syntaxe

Remove-Event [-EventIdentifier] <int> [-Confirmer] [-WhatIf] [<CommonParameters>]

Remove-Event [-SourceIdentifier] <string> [-Confirmer] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Remove-Event supprime des événements de la file d'attente d'événements de la session active.

Cette applet de commande supprime uniquement les événements présents dans la file d'attente. Pour annuler des inscriptions à des événements ou annuler un abonnement, utilisez l'applet de commande Unregister-Event.

Paramètres

-EventIdentifier <int>

Supprime uniquement l'événement possédant l'identificateur d'événement spécifié. Un paramètre EventIdentifier ou SourceIdentifier est requis dans chaque commande.

Obligatoire ?	true
Position ?	1
Valeur par défaut	aucun
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	false

-SourceIdentifier <string>

Supprime uniquement les événements possédant l'identificateur source spécifié. Les caractères génériques ne sont pas autorisés. Un paramètre EventIdentifier ou SourceIdentifier est requis dans chaque commande.

Obligatoire ?	true
Position ?	1
Valeur par défaut	aucun
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Confirmer

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

System.Management.Automation.PSEventArgs

Vous pouvez diriger des événements de Get-Event vers Remove-Event.

Sorties

Aucun

L'applet de commande ne génère aucune sortie.

Remarques

Les événements, les abonnements aux événements et la file d'attente d'événements existent uniquement dans la session active. Si vous fermez la session active, la file d'attente des événements est ignorée et l'abonnement aux événements est annulé.

Exemple 1

C:\PS>remove-event -sourceIdentifier "ProcessStarted"

Description
-----------
Cette commande supprime les événements possédant l'identificateur source « Process Started » de la file d'attente d'événements.

Exemple 2

C:\PS>remove-event -eventIdentifier 30

Description
-----------
Cette commande supprime l'événement possédant l'ID 30 de la file d'attente d'événements.

Exemple 3

C:\PS>get-event | remove-event

Description
-----------
Cette commande supprime tous les événements de la file d'attente d'événements.