Remove-Event
Удаляет события из очереди событий.
Синтаксис
BySource (по умолчанию)
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
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
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EventIdentifier
Указывает идентификатор события, для которого удаляется командлет. Параметр EventIdentifier или SourceIdentifier требуется в каждой команде.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByIdentifier
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-SourceIdentifier
Указывает исходный идентификатор, из которого этот командлет удаляет события. Подстановочные знаки запрещены. Параметр EventIdentifier или SourceIdentifier требуется в каждой команде.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
BySource
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
PSEventArgs
События можно передать из Get-Event в этот командлет.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
На платформах Linux или macOS нет источников событий.
События, подписки на события и очередь событий существуют только в текущем сеансе. При закрытии текущего сеанса очередь событий удаляется, а подписка на события отменяется.
