Remove-Event

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

Синтаксис

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

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

Описание

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

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

Параметры

-EventIdentifier <int>

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

Обязательно?	true
Позиция?	1
Значение по умолчанию	нет
Принимать входные данные из конвейера?	true (ByPropertyName)
Принимать подстановочные знаки?	false

-SourceIdentifier <string>

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

Обязательно?	true
Позиция?	1
Значение по умолчанию	нет
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Confirm

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

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

System.Management.Automation.PSEventArgs

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

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

Нет

Командлет не формирует никаких выходных данных.

Примечания

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

Пример 1

C:\PS>remove-event -sourceIdentifier "ProcessStarted"

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

Пример 2

C:\PS>remove-event -eventIdentifier 30

Описание
-----------
Эта команда удаляет из очереди событие с идентификатором, равным 30.

Пример 3

C:\PS>get-event | remove-event

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