Register-CimIndicationEvent

Ссылка

Модуль:: CimCmdlets

Подписывается на признаки с помощью выражения фильтра или выражения запроса.

Синтаксис

Register-CimIndicationEvent
        [-Namespace <String>]
        [-ClassName] <String>
        [-OperationTimeoutSec <UInt32>]
        [-ComputerName <String>]
        [[-SourceIdentifier] <String>]
        [[-Action] <ScriptBlock>]
        [-MessageData <PSObject>]
        [-SupportEvent]
        [-Forward]
        [-MaxTriggerCount <Int32>]
        [<CommonParameters>]

Register-CimIndicationEvent
        [-Namespace <String>]
        [-ClassName] <String>
        [-OperationTimeoutSec <UInt32>]
        -CimSession <CimSession>
        [[-SourceIdentifier] <String>]
        [[-Action] <ScriptBlock>]
        [-MessageData <PSObject>]
        [-SupportEvent]
        [-Forward]
        [-MaxTriggerCount <Int32>]
        [<CommonParameters>]

Register-CimIndicationEvent
        [-Namespace <String>]
        [-Query] <String>
        [-QueryDialect <String>]
        [-OperationTimeoutSec <UInt32>]
        -CimSession <CimSession>
        [[-SourceIdentifier] <String>]
        [[-Action] <ScriptBlock>]
        [-MessageData <PSObject>]
        [-SupportEvent]
        [-Forward]
        [-MaxTriggerCount <Int32>]
        [<CommonParameters>]

Register-CimIndicationEvent
        [-Namespace <String>]
        [-Query] <String>
        [-QueryDialect <String>]
        [-OperationTimeoutSec <UInt32>]
        [-ComputerName <String>]
        [[-SourceIdentifier] <String>]
        [[-Action] <ScriptBlock>]
        [-MessageData <PSObject>]
        [-SupportEvent]
        [-Forward]
        [-MaxTriggerCount <Int32>]
        [<CommonParameters>]

Описание

Этот командлет доступен только на платформе Windows.

Register-CimIndicationEvent Командлет подписывается на признаки с помощью имени класса указания или выражения запроса. Используйте параметр SourceIdentifier, дающий имя подписке.

Этот командлет возвращает объект EventSubscription . Этот объект можно использовать для отмены подписки.

Примеры

Пример 1. Регистрация событий, созданных классом

Этот пример подписывается на события, созданные классом с именем Win32_ProcessStartTrace. Этот класс вызывает событие при запуске процесса.

Register-CimIndicationEvent -ClassName 'Win32_ProcessStartTrace' -SourceIdentifier "ProcessStarted"
Get-Event -SourceIdentifier "ProcessStarted"

Командлет Get-Event получает события с подпиской ProcessStarted . Дополнительные сведения см. в разделе Get-Event.

Примечание.

В этом примере необходимо запустить PowerShell в качестве Администратор istrator.

Пример 2. Регистрация событий с помощью запроса

В этом примере используется запрос для подписки на событие, созданное при каждом изменении экземпляра класса с именем Win32_LocalTime.

$query = "SELECT * FROM CIM_InstModification WHERE TargetInstance ISA 'Win32_LocalTime'"
Register-CimIndicationEvent -Query $query -SourceIdentifier "Timer"

Пример 3. Запуск скрипта при поступлении события

В этом примере показано, как использовать действие в ответ на событие. Переменная содержит блок скрипта для Action, который использует $event переменную $action для доступа к событию, полученному из CIM.

$action = {
  $name = $event.SourceEventArgs.NewEvent.ProcessName
  $id = $event.SourceEventArgs.NewEvent.ProcessId
  Write-Host -Object "New Process Started : Name = $name
 ID = $id"
}
Register-CimIndicationEvent -ClassName 'Win32_ProcessStartTrace' -SourceIdentifier "ProcessStarted" -Action $action

Дополнительные сведения см. в Win32_ProcessStartTrace.

Пример 4. Регистрация событий на удаленном компьютере

Этот пример подписывается на события на удаленном компьютере с именем Server01. События, полученные от сервера CIM, хранятся в очереди событий в текущем сеансе PowerShell, а затем запускает локальный Get-Event объект для получения событий.

Register-CimIndicationEvent -ClassName 'Win32_ProcessStartTrace' -SourceIdentifier "ProcessStarted" -ComputerName Server01
Get-Event -SourceIdentifier "ProcessStarted"

Параметры

-Action

Задает команды, обрабатывающие события. Команды, указанные этим параметром, выполняются при возникновении события, а не отправки события в очередь событий. Заключите команды в фигурные скобки ({}) для создания блока скрипта.

Блок скрипта, указанный с помощью действия, может включать $Eventпеременные , $EventSubscriber$Sender$SourceEventArgsи $SourceArgs автоматические переменные, предоставляющие сведения о событии в блок скрипта Action. Дополнительные сведения см. в разделе "Об автоматических переменных".

Type:	ScriptBlock
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CimSession

Выполняет команду с помощью указанного сеанса CIM. Введите переменную, содержащую сеанс CIM, или команду, которая создает или получает сеанс CIM, например New-CimSession командлеты или Get-CimSession командлеты. Дополнительные сведения см. в about_CimSession.

Type:	CimSession
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ClassName

Указывает класс указания, которому вы подписываетесь. Вы можете использовать завершение вкладки для просмотра списка классов, так как PowerShell получает список классов с локального сервера WMI для предоставления списка имен классов.

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

-ComputerName

Указывает имя компьютера, на котором требуется выполнить операцию CIM. Можно указать полное доменное имя (FQDN), имя NetBIOS или IP-адрес.

При указании этого параметра командлет создает временный сеанс для указанного компьютера с помощью протокола WsMan. Если этот параметр не указан, командлет выполняет операцию в локальной системе с помощью объектной модели компонента (COM).

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

Type:	String
Aliases:	CN, ServerName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Forward

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

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

-MaxTriggerCount

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

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

-MessageData

Указывает дополнительные данные, которые необходимо связать с этой подпиской на событие. Значение этого параметра отображается в свойстве MessageData всех событий, связанных с этой подпиской.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Namespace

Указывает пространство имен для операции CIM. Пространство имен по умолчанию — root/cimv2. Вы можете использовать завершение вкладки для просмотра списка пространств имен, так как PowerShell получает список пространств имен с локального сервера WMI для предоставления списка пространств имен.

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

-OperationTimeoutSec

Указывает время ожидания командлетом ответа от компьютера. По умолчанию значение этого параметра равно 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера.

Если параметр OperationTimeoutSec имеет значение меньше времени ожидания надежного повтора подключения в течение 3 минут, сетевые сбои, которые длились больше, чем значение параметра OperationTimeoutSec, невозможно восстановить, так как операция на сервере истекает до повторного подключения клиента.

Type:	UInt32
Aliases:	OT
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Query

Указывает запрос, выполняемый на сервере CIM. Если указанное значение содержит двойные кавычки ", одинарные кавычки 'или обратную косую черту \, необходимо экранировать эти символы, префиксируя их символом обратной косой черты. Если указанное значение использует оператор WQL LIKE, необходимо экранировать следующие символы, заключив их в квадратные скобки []: процент %, подчеркивание _или открытие квадратной скобки [.

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

-QueryDialect

Указывает язык запросов, используемый для параметра query . Допустимые значения для этого параметра: WQL или CQL. Значение по умолчанию — WQL.

Type:	String
Position:	Named
Default value:	WQL
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SourceIdentifier

Указывает имя подписки. Указанное имя должно быть уникальным в текущем сеансе. Значение по умолчанию — это GUID, который назначает PowerShell. Это значение отображается в значении свойства SourceIdentifier объекта подписчика и всех объектов событий, связанных с этой подпиской.

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

-SupportEvent

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

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

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

None

Невозможно передать объекты в этот командлет.

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

Object

Этот командлет возвращает объект EventSubscription .

Примечания

PowerShell включает следующие псевдонимы для Register-CimIndicationEvent:

Windows:
- rcie

Этот командлет доступен только на платформах Windows.

Register-CimIndicationEvent

Синтаксис

Описание

Примеры

Пример 1. Регистрация событий, созданных классом

Пример 2. Регистрация событий с помощью запроса

Пример 3. Запуск скрипта при поступлении события

Пример 4. Регистрация событий на удаленном компьютере

Параметры

-Action

-CimSession

-ClassName

-ComputerName

-Forward

-MaxTriggerCount

-MessageData

-Namespace

-OperationTimeoutSec

-Query

-QueryDialect

-SourceIdentifier

-SupportEvent

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

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

Примечания

Обратная связь

Дополнительные ресурсы

Register-CimIndicationEvent

Синтаксис

Описание

Примеры

Пример 1. Регистрация событий, созданных классом

Пример 2. Регистрация событий с помощью запроса

Пример 3. Запуск скрипта при поступлении события

Пример 4. Регистрация событий на удаленном компьютере

Параметры

-Action

-CimSession

-ClassName

-ComputerName

-Forward

-MaxTriggerCount

-MessageData

-Namespace

-OperationTimeoutSec

-Query

-QueryDialect

-SourceIdentifier

-SupportEvent

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

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

Примечания

Связанные ссылки

Обратная связь

Дополнительные ресурсы