Remove-Event
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 de source
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
Cette commande supprime les événements dont l’identificateur source est Processus démarré 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 pour lequel 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
Vous pouvez diriger les événements de vers Get-Event
Remove-Event
.
Sorties
None
L'applet de commande ne génère pas de résultat.
Notes
Aucune source d’événement 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é.