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

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 нет источников событий.

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