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

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventIdentifier

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

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourceIdentifier

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

PSEventArgs

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

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

None

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

Примечания

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

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