Remove-Event

Usuwa zdarzenia z kolejki zdarzeń.

Składnia

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

Opis

Polecenie Remove-Event cmdlet 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 Unregister-Event polecenia cmdlet .

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventIdentifier

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

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

PSEventArgs

Zdarzenia można potokować z Get-Event tego polecenia cmdlet 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.