Remove-Event
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.
Voir aussi
Concepts
Register-ObjectEvent
Register-EngineEvent
Register-WmiEvent
Unregister-Event
Get-Event
New-Event
Remove-Event
Wait-Event