Udostępnij za pośrednictwem

Remove-Event

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Usuwa zdarzenia z kolejki zdarzeń.

Składnia

Remove-Event
      [-SourceIdentifier] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Event
      [-EventIdentifier] <Int32>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-Event usuwa zdarzenia z kolejki zdarzeń w bieżącej sesji.

To polecenie cmdlet usuwa tylko zdarzenia aktualnie w kolejce. Aby anulować rejestracje zdarzeń lub anulować subskrypcję, użyj polecenia cmdlet Unregister-Event.

Przykłady

Przykład 1. Usuwanie zdarzenia według identyfikatora źródłowego

PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"

To polecenie usuwa zdarzenia z identyfikatorem źródłowym Procesu rozpoczętego z kolejki zdarzeń.

Przykład 2. Usuwanie zdarzenia według identyfikatora zdarzenia

PS C:\> Remove-Event -EventIdentifier 30

To polecenie usuwa zdarzenie o identyfikatorze zdarzenia 30 z kolejki zdarzeń.

Przykład 3. Usuwanie wszystkich zdarzeń

PS C:\> Get-Event | Remove-Event

To polecenie usuwa wszystkie zdarzenia z kolejki zdarzeń.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EventIdentifier

Określa identyfikator zdarzenia, dla którego polecenie cmdlet usuwa. Parametr EventIdentifier lub SourceIdentifier jest wymagany w każdym poleceniu.

Typ:Int32
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SourceIdentifier

Określa identyfikator źródła, z którego to polecenie cmdlet usuwa zdarzenia. Symbole wieloznaczne nie są dozwolone. Parametr EventIdentifier lub SourceIdentifier jest wymagany w każdym poleceniu.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSEventArgs

Zdarzenia można potokować z Get-Event do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Brak źródeł zdarzeń dostępnych na platformach Linux lub macOS.

Zdarzenia, subskrypcje zdarzeń i kolejka zdarzeń istnieją tylko w bieżącej sesji. Jeśli zamkniesz bieżącą sesję, kolejka zdarzeń zostanie odrzucona i subskrypcja zdarzeń zostanie anulowana.