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
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.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla