Remove-Event
Supprime les événements de la file d’attente d’événements.
Syntaxe
BySource (Par défaut)
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
Remove-Event
[-EventIdentifier] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Remove-Event supprime les événements de la file d’attente d’événements dans la session active.
Cette applet de commande supprime uniquement les événements actuellement dans la file d’attente. Pour annuler les inscriptions d’événements ou vous désabonner, utilisez l’applet de commande Unregister-Event.
Exemples
Exemple 1 : Supprimer un événement par identificateur source
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
Cette commande supprime les événements dont l'identificateur source est "Process Started" de la file d'attente des é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 de 30 dans la file d’attente d’é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 d’événements.
Paramètres
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ByIdentifier
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
BySource
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
PSEventArgs
Vous pouvez diriger des événements de Get-Event vers cette applet de commande.
Sorties
None
Cette applet de commande ne retourne aucune 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 la session active, la file d’attente d’événements est ignorée et l’abonnement à l’événement est annulé.
