Register-CimIndicationEvent

Sintaxis

ClassNameComputerSet (Es el valor predeterminado).

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

ClassNameSessionSet

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

QueryExpressionSessionSet

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

QueryExpressionComputerSet

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

Description

Ejemplos

Ejemplo 1: Registrar los eventos generados por una clase

$event = @{
    ClassName = 'Win32_ProcessStartTrace'
    SourceIdentifier = 'ProcessStarted'
}
Register-CimIndicationEvent @event
Get-Event -SourceIdentifier "ProcessStarted"

Ejemplo 2: Registrar los eventos mediante una consulta

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

Ejemplo 3: Ejecutar un script cuando llegue el evento

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

Ejemplo 4: Registrar los eventos en un equipo remoto

$event = @{
    ClassName = 'Win32_ProcessStartTrace'
    SourceIdentifier = 'ProcessStarted'
    ComputerName = 'Server01'
}
Register-CimIndicationEvent @event
Get-Event -SourceIdentifier "ProcessStarted"

Parámetros

-Action

Especifica los comandos que controlan los eventos. Los comandos especificados por este parámetro se ejecutan cuando se genera un evento, en lugar de enviar el evento a la cola de eventos. Incluya los comandos entre llaves ({}) para crear un bloque de script.

El bloque de script especificado con Action puede incluir el $Event, $EventSubscriber, $Sender, $SourceEventArgsy $SourceArgs variables automáticas, que proporcionan información sobre el evento al bloque de script Action. Para obtener más información, vea Acerca de las variables automáticas.

Propiedades del parámetro

Conjuntos de parámetros

-CimSession

Ejecuta el comando mediante la sesión CIM especificada. Escriba una variable que contenga la sesión CIM o un comando que cree o obtenga la sesión CIM, como los cmdlets New-CimSession o Get-CimSession. Para obtener más información, consulte about_CimSession.

Propiedades del parámetro

Conjuntos de parámetros

-ClassName

Especifica a qué clase de indicación se está usted suscribiendo. Puede utilizar el autocompletado de tabulaciones para examinar la lista de clases, ya que PowerShell obtiene una lista de clases del servidor WMI local para proporcionar una lista de nombres de clases.

Propiedades del parámetro

Conjuntos de parámetros

-ComputerName

Especifica el nombre del equipo en el que desea ejecutar la operación CIM. Puede especificar un nombre de dominio completo (FQDN), un nombre NetBIOS o una dirección IP.

Si especifica este parámetro, el cmdlet crea una sesión temporal en el equipo especificado mediante el protocolo WsMan. Si no especifica este parámetro, el cmdlet realiza la operación en el sistema local mediante el modelo de objetos componentes (COM).

Si se realizan varias operaciones en el mismo equipo, conéctese mediante una sesión CIM para mejorar el rendimiento.

Propiedades del parámetro

Conjuntos de parámetros

-Forward

Indica que los eventos de la suscripción se reenvían a la sesión en el equipo local. Use este parámetro cuando se registren eventos en un equipo remoto o en una sesión remota.

Propiedades del parámetro

Conjuntos de parámetros

-MaxTriggerCount

Parámetro para indicar que el suscriptor debe darse de baja automáticamente después de activarse un número especificado de veces. Si el valor es igual o menor que cero, no hay ningún límite en el número de veces que se puede desencadenar el evento sin que se anule el registro.

Propiedades del parámetro

Conjuntos de parámetros

-MessageData

Especifica los datos adicionales que se van a asociar a esta suscripción de eventos. El valor de este parámetro aparece en la propiedad MessageData de todos los eventos asociados a esta suscripción.

Propiedades del parámetro

Conjuntos de parámetros

-Namespace

Especifica el espacio de nombres para la operación CIM. El espacio de nombres predeterminado es raíz/CIMV2. Puede usar la finalización de tabulación para examinar la lista de espacios de nombres, ya que PowerShell obtiene una lista de espacios de nombres del servidor WMI local para proporcionar la lista de espacios de nombres.

Propiedades del parámetro

Conjuntos de parámetros

-OperationTimeoutSec

Especifica la cantidad de tiempo que el cmdlet espera una respuesta del equipo. De forma predeterminada, el valor de este parámetro es 0, lo que significa que el cmdlet usa el valor de tiempo de espera predeterminado para el servidor.

Si el parámetro OperationTimeoutSec se establece en un valor menor que el tiempo de espera de reintento de conexión sólido de 3 minutos, los errores de red que duran más que el valor del parámetro OperationTimeoutSec no se pueden recuperar, ya que la operación en el servidor agota el tiempo de espera antes de que el cliente pueda volver a conectarse.

Propiedades del parámetro

Conjuntos de parámetros

-Query

Especifica una consulta que se va a ejecutar en el servidor CIM. Si el valor especificado contiene comillas dobles ", comillas simples ' o una barra diagonal inversa \, debe preceder esos caracteres anteponiéndoles el carácter de barra diagonal inversa. Si el valor especificado utiliza el operador LIKE de WQL, debe agregar caracteres de escape a los siguientes caracteres encerrándolos entre corchetes []: porcentaje %, subrayado _ o corchete de apertura [.

Propiedades del parámetro

Conjuntos de parámetros

-QueryDialect

Especifica el lenguaje de consulta usado para el parámetro de consulta Consulta. Los valores aceptables para este parámetro son: WQL o CQL. El valor predeterminado es WQL.

Propiedades del parámetro

Conjuntos de parámetros

-SourceIdentifier

Especifica un nombre para la suscripción. El nombre que especifique debe ser único en la sesión actual. El valor predeterminado es un GUID que Asigna PowerShell. Este valor aparece en el valor del propiedad SourceIdentifier del objeto de suscriptor y de todos los objetos de evento asociados a esta suscripción.

Propiedades del parámetro

Conjuntos de parámetros

-SupportEvent

Indica que la suscripción de eventos está oculta. Use este parámetro cuando la suscripción actual forme parte de un mecanismo de registro de eventos más complejo y no se debe detectar de forma independiente.

Propiedades del parámetro

Conjuntos de parámetros

CommonParameters

Entradas

None

Salidas

Object

Vínculos relacionados

• Get-Event
• Remove-Event (Eliminar evento)
• Unregister-Event
• Write-Host
• Get-CimSession
• New-CimSession