Partager via

Remove-Event

  • Référence
Module:
Microsoft.PowerShell.Utility

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

Syntaxe

Remove-Event
      [-SourceIdentifier] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Event
      [-EventIdentifier] <Int32>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet Remove-Event de commande supprime les événements de la file d’attente d’événements dans la session active.

Cette applet de commande ne supprime que les événements actuellement dans la file d'attente. Pour annuler les inscriptions d’événements ou vous désabonner, utilisez l’applet de Unregister-Event commande.

Exemples

Exemple 1 : Supprimer un événement par identificateur source

PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"

Cette commande supprime les événements avec un identificateur source de Process Started à partir de la file d’attente d’événements.

Exemple 2 : Supprimer un événement par identificateur d’événement

PS C:\> Remove-Event -EventIdentifier 30

Cette commande supprime l'événement avec un ID d'événement égal à 30 de la file d'attente des événements.

Exemple 3 : Supprimer tous les événements

PS C:\> Get-Event | Remove-Event

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

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EventIdentifier

Spécifie l’identificateur d’événement pour lequel l’applet de commande supprime. Un paramètre EventIdentifier ou SourceIdentifier est requis dans chaque commande.

Type:Int32
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SourceIdentifier

Spécifie l’identificateur source dont cette applet de commande supprime les événements. Les caractères génériques ne sont pas autorisés. Un paramètre EventIdentifier ou SourceIdentifier est requis dans chaque commande.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSEventArgs

Vous pouvez diriger des événements vers cette applet de Get-Event commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

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 cette session, la file d'attente d'événements est ignorée et l'abonnement aux événements est annulé.