Udostępnij za pośrednictwem

Unregister-Event

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

Anuluje subskrypcję zdarzeń.

Składnia

Unregister-Event
          [-SourceIdentifier] <String>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-Event
          [-SubscriptionId] <Int32>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Opis

Polecenie Unregister-Event cmdlet anuluje subskrypcję zdarzeń utworzoną przy użyciu Register-EngineEventpolecenia cmdlet , Register-ObjectEventlub Register-WmiEvent .

Po anulowaniu subskrypcji zdarzeń subskrybent zdarzenia jest usuwany z sesji, a subskrybowane zdarzenia nie są już dodawane do kolejki zdarzeń. Po anulowaniu subskrypcji do zdarzenia utworzonego New-Event przy użyciu polecenia cmdlet nowe zdarzenie zostanie również usunięte z sesji.

Unregister-Event nie usuwa zdarzeń z kolejki zdarzeń. Aby usunąć zdarzenia, użyj Remove-Event polecenia cmdlet .

Przykłady

Przykład 1. Anulowanie subskrypcji zdarzeń według identyfikatora źródłowego

To polecenie anuluje subskrypcję zdarzeń, która ma identyfikator źródłowy ProcessStarted.

Unregister-Event -SourceIdentifier "ProcessStarted"

Aby znaleźć identyfikator źródłowy zdarzenia, użyj Get-Event polecenia cmdlet . Aby znaleźć identyfikator źródłowy subskrypcji zdarzeń, użyj Get-EventSubscriber polecenia cmdlet

Przykład 2. Anulowanie subskrypcji zdarzeń według identyfikatora subskrypcji

To polecenie anuluje subskrypcję zdarzeń, która ma identyfikator subskrypcji 2.

Unregister-Event -SubscriptionId 2

Aby znaleźć identyfikator subskrypcji zdarzeń, użyj Get-EventSubscriber polecenia cmdlet .

Przykład 3. Anulowanie wszystkich subskrypcji zdarzeń

W tym przykładzie wszystkie subskrypcje zdarzeń są anulowane w sesji.

Get-EventSubscriber -Force | Unregister-Event -Force

Użycie parametru Force z Get-EventSubscriber pobiera wszystkie obiekty subskrybenta zdarzeń w sesji, w tym subskrybentów, którzy są ukryte. Dane wyjściowe są przesyłane potokami do Unregister-Eventelementu , który usuwa subskrybentów z sesji. Parametr Force jest wymagany, Unregister-Event aby usunąć wszystkich ukrytych subskrybentów.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliases:cf
Position:Named
wartość domyślna:False
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Anuluje wszystkie subskrypcje zdarzeń, w tym subskrypcje, które zostały ukryte przy użyciu parametru SupportEvent parametru Register-ObjectEvent, Register-WmiEventi Register-EngineEvent.

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

Określa identyfikator źródła, który to polecenie cmdlet anuluje subskrypcje zdarzeń.

Parametr SourceIdentifier lub SubscriptionId musi być uwzględniony w każdym poleceniu.

Typ:String
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

Określa identyfikator źródła, który to polecenie cmdlet anuluje subskrypcje zdarzeń.

Parametr SourceIdentifier lub SubscriptionId musi być uwzględniony w każdym poleceniu.

Typ:Int32
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Typ:SwitchParameter
Aliases:wi
Position:Named
wartość domyślna:False
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

PSEventSubscriber

Możesz przekazać dane wyjściowe z Get-EventSubscriber do tego polecenia cmdlet.

Dane wyjściowe

None

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

Uwagi

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.

Unregister-Event program nie może usunąć zdarzeń utworzonych przy użyciu New-Event polecenia cmdlet , chyba że zasubskrybujesz zdarzenie za pomocą Register-EngineEvent polecenia cmdlet . Aby usunąć zdarzenie niestandardowe z sesji, należy usunąć je programowo lub zamknąć sesję.