Remove-Event

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

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

Syntax

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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Aucune source d’événements n’est disponible sur les plateformes Linux ou macOS.

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é.