Remove-Event (Microsoft.PowerShell.Utility)

Remove-Event

Модуль:: Microsoft.PowerShell.Utility

Удаляет события из очереди событий.

Синтаксис

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

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

Описание

Командлет Remove-Event удаляет события из очереди событий в текущем сеансе.

Этот командлет удаляет только те события, которые в данный момент находятся в очереди. Чтобы отменить регистрацию событий или отказаться от подписки, используйте командлет Unregister-Event.

Примеры

Пример 1. Удаление события по идентификатору источника

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

Эта команда удаляет события с идентификатором источника «Процесс запущен» из очереди событий.

Пример 2. Удаление события по идентификатору события

PS C:\> Remove-Event -EventIdentifier 30

Эта команда удаляет событие с идентификатором события 30 из очереди событий.

Пример 3. Удаление всех событий

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

Эта команда удаляет все события из очереди событий.

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип :: SwitchParameter
Псевдонимы:: cf
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-EventIdentifier

Указывает идентификатор события, для которого командлет удаляет. Параметр EventIdentifier или SourceIdentifier необходим в каждой команде.

Тип :: Int32
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-SourceIdentifier

Указывает идентификатор источника, из которого этот командлет удаляет события. Подстановочные знаки не допускаются. Параметр EventIdentifier или SourceIdentifier необходим в каждой команде.

Тип :: String
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-WhatIf

Показывает, что произойдет, если командлет запустится. Командлет не запускается.

Тип :: SwitchParameter
Псевдонимы:: wi
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

PSEventArgs

Вы можете передать события из Get-Event в этот командлет.

Выходы

Нет

Этот командлет не возвращает никаких результатов.

Примечания

На платформах Linux или macOS нет источников событий.

События, подписки на события и очередь событий существуют только в текущем сеансе. Если вы закроете текущий сеанс, очередь событий будет удалена, а подписка на события будет отменена.