Register-WmiEvent

Register-WmiEvent
    [-Class] <String>
    [[-SourceIdentifier] <String>]
    [[-Action] <ScriptBlock>]
    [-Namespace <String>]
    [-Credential <PSCredential>]
    [-ComputerName <String>]
    [-Timeout <Int64>]
    [-MessageData <PSObject>]
    [-SupportEvent]
    [-Forward]
    [-MaxTriggerCount <Int32>]
    [<CommonParameters>]

Register-WmiEvent
    [-Query] <String>
    [[-SourceIdentifier] <String>]
    [[-Action] <ScriptBlock>]
    [-Namespace <String>]
    [-Credential <PSCredential>]
    [-ComputerName <String>]
    [-Timeout <Int64>]
    [-MessageData <PSObject>]
    [-SupportEvent]
    [-Forward]
    [-MaxTriggerCount <Int32>]
    [<CommonParameters>]

L’applet Register-WmiEvent de commande s’abonne aux événements WMI (Windows Management Instrumentation) sur l’ordinateur local ou sur un ordinateur distant.

Lorsque l’événement WMI abonné est déclenché, il est ajouté à la file d’attente d’événements dans votre session locale, même si l’événement se produit sur un ordinateur distant. Pour obtenir des événements dans la file d’attente d’événements, utilisez l’applet de commande Get-Event.

Vous pouvez utiliser les paramètres de Register-WmiEvent pour vous abonner à des événements sur des ordinateurs distants et spécifier les valeurs de propriété des événements qui peuvent vous aider à identifier l’événement dans la file d’attente. Vous pouvez également utiliser le paramètre Action pour spécifier les actions à entreprendre lorsqu’un événement abonné est déclenché.

Lorsque vous vous abonnez à un événement, un abonné à un événement est ajouté à votre session. Pour obtenir les abonnés à l’événement dans la session, utilisez le cmdlet Get-EventSubscriber. Pour annuler l’abonnement, utilisez l’applet de commande Unregister-Event, qui supprime l’abonné à l’événement de la session.

Les nouvelles applets de commande CIM (Common Information Model), introduites par Windows PowerShell 3.0, effectuent les mêmes tâches que les applets de commande WMI. Les applets de commande CIM sont conformes aux normes WS-Management (WSMan) et à la norme CIM, ce qui permet aux applets de commande d’utiliser les mêmes techniques pour gérer les ordinateurs qui exécutent le système d’exploitation Windows et ceux qui exécutent d’autres systèmes d’exploitation. Au lieu d’utiliser , envisagez d’utiliser l’applet de commande Register-CimIndicationEvent .

Cette commande s’abonne aux événements générés par la classe Win32_ProcessStartTrace. Cette classe déclenche un événement chaque fois qu’un processus démarre.

Register-WmiEvent -Class 'Win32_ProcessStartTrace' -SourceIdentifier "ProcessStarted"

Cette commande utilise une requête pour s’abonner à Win32_process événements de création d’instance.

$wmiParameters = @{
  Query = "select * from __instancecreationevent within 5 where targetinstance isa 'Win32_Process'"
  SourceIdentifier = "WMIProcess"
  MessageData = "Test 01"
  TimeOut = 500
}
Register-WmiEvent @wmiParameters

Cet exemple montre comment utiliser une action pour répondre à un événement. Dans ce cas, lorsqu’un processus démarre, toutes les Start-Process commandes de la session active sont écrites dans un fichier XML.

$action = {
    Get-History |
    Where-Object { $_.CommandLine -like "*Start-Process*" } |
    Export-CliXml "commandHistory.clixml"
}
Register-WmiEvent -Class Win32_ProcessStartTrace -SourceIdentifier ProcessStarted -Action $action

Id    Name            State      HasMoreData   Location  Command
--    ----            -----      -----------   --------  -------
1     ProcessStarted  NotStarted False                   Get-History | where {...

Lorsque vous utilisez le paramètre Action , Register-WmiEvent retourne un travail en arrière-plan qui représente l’action d’événement. Vous pouvez utiliser les applets de commande Job , telles que Get-Job et Receive-Job, pour gérer le travail d’événement.

Pour plus d’informations, consultez à propos des_tâches.

Cet exemple s’inscrit pour les événements sur l’ordinateur distant Server01.

Register-WmiEvent -Class 'Win32_ProcessStartTrace' -SourceIdentifier "Start" -ComputerName Server01
Get-Event -SourceIdentifier "Start"

WMI retourne les événements sur l’ordinateur local et les stocke dans la file d’attente des événements dans la session active. Pour récupérer les événements, exécutez une commande locale Get-Event .

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Cette applet de commande ne génère aucune sortie.

Pour utiliser cette applet de commande dans Windows Vista ou une version ultérieure du système d’exploitation Windows, démarrez Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur.

Les événements, les abonnements aux événements et la file d’attente d’événements existent uniquement dans la session active. Si vous fermez la session active, la file d’attente d’événements est ignorée et l’abonnement à l’événement est annulé.