Поделиться через

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"

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

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

PS C:\> Remove-Event -EventIdentifier 30

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

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

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

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

Параметры

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EventIdentifier

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

Тип:Int32
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SourceIdentifier

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

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

PSEventArgs

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

Выходные данные

None

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

Примечания

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

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