Remove-Event
Tar bort händelser från händelsekön.
Syntax
BySource (Standard)
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
Remove-Event
[-EventIdentifier] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdleten Remove-Event tar bort händelser från händelsekön i den aktuella sessionen.
Den här cmdleten tar bara bort de händelser som för närvarande finns i kön. Om du vill avbryta händelseregistreringar eller avbryta prenumerationen använder du cmdleten Unregister-Event.
Exempel
Exempel 1: Ta bort en händelse efter källidentifierare
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
Det här kommandot tar bort händelser med en källidentifierare för Process started från händelsekön.
Exempel 2: Ta bort en händelse efter händelseidentifierare
PS C:\> Remove-Event -EventIdentifier 30
Det här kommandot tar bort händelsen med ett händelse-ID på 30 från händelsekön.
Exempel 3: Ta bort alla händelser
PS C:\> Get-Event | Remove-Event
Det här kommandot tar bort alla händelser från händelsekön.
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-EventIdentifier
Anger den händelseidentifierare som cmdleten tar bort. En EventIdentifier-- eller SourceIdentifier--parameter krävs i varje kommando.
Parameteregenskaper
| Typ: | Int32 |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
ByIdentifier
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-SourceIdentifier
Anger den källidentifierare som den här cmdleten tar bort händelser från. Jokertecken är inte tillåtna. En EventIdentifier-- eller SourceIdentifier--parameter krävs i varje kommando.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
BySource
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
PSEventArgs
Du kan skicka händelser från Get-Event till den här cmdleten.
Utdata
None
Den här cmdleten returnerar inga utdata.
Kommentarer
Inga händelsekällor är tillgängliga på Linux- eller macOS-plattformarna.
Händelser, händelseprenumerationer och händelsekön finns bara i den aktuella sessionen. Om du stänger den aktuella sessionen ignoreras händelsekön och händelseprenumerationen avbryts.
