Register-WmiEvent

Sintassi

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

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

Descrizione

Il Register-WmiEvent cmdlet sottoscrive gli eventi di Strumentazione gestione Windows (WMI) nel computer locale o in un computer remoto.

Quando viene generato l'evento WMI sottoscritto, viene aggiunto alla coda degli eventi nella sessione locale anche se l'evento si verifica in un computer remoto. Per ottenere eventi nella coda di eventi, usare il Get-Event cmdlet .

È possibile usare i parametri di Register-WmiEvent per sottoscrivere gli eventi nei computer remoti e per specificare i valori delle proprietà degli eventi che consentono di identificare l'evento nella coda. È anche possibile usare il parametro Action per specificare le azioni da eseguire quando viene generato un evento sottoscritto.

Quando si sottoscrive un evento viene aggiunto un sottoscrittore di eventi alla sessione. Per ottenere i sottoscrittori di eventi nella sessione, usare il Get-EventSubscriber cmdlet . Per annullare la sottoscrizione, usare il Unregister-Event cmdlet , che elimina il sottoscrittore di eventi dalla sessione.

Nuovi cmdlet CIM (Common Information Model), introdotti in Windows PowerShell 3.0, eseguono le stesse attività dei cmdlet WMI. I cmdlet CIM sono conformi agli standard WS-Management (WSMan) e allo standard CIM, che consente ai cmdlet di usare le stesse tecniche per gestire i computer che eseguono il sistema operativo Windows e quelli che eseguono altri sistemi operativi. Invece di usare Register-WmiEvent, è consigliabile usare il cmdlet Register-CimIndicationEvent .

Esempio

Esempio 1: Sottoscrivere eventi generati da una classe

Questo comando sottoscrive gli eventi generati dalla classe Win32_ProcessStartTrace . Questa classe genera un evento ogni volta che viene avviato un processo.

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

Esempio 2: Sottoscrivere eventi di creazione per un processo

Questo comando usa una query per sottoscrivere gli eventi di creazione istanze di Win32_process.

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

Esempio 3: Usare un'azione per rispondere a un evento

Questo esempio illustra come usare un'azione per rispondere a un evento. In questo caso, all'avvio di un processo, tutti Start-Process i comandi nella sessione corrente vengono scritti in un file XML.

$action = { Get-History | where { $_.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 {...

Quando si usa il parametro Action , Register-WmiEvent restituisce un processo in background che rappresenta l'azione dell'evento. È possibile usare i cmdlet job , ad esempio Get-Job e Receive-Job, per gestire il processo dell'evento.

Per altre informazioni, vedere About Jobs (Informazioni sui processi).

Esempio 4: Eseguire la registrazione per gli eventi in un computer remoto

Questo esempio esegue la registrazione agli eventi nel computer remoto Server01.

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

WMI restituisce gli eventi al computer locale e li archivia nella coda degli eventi nella sessione corrente. Per recuperare gli eventi, eseguire un comando locale Get-Event .

Parametri

-Action

-Class

-ComputerName

-Credential

-Forward

-MaxTriggerCount

-MessageData

-Namespace

-Query

-SourceIdentifier

-SupportEvent

-Timeout

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

None

Questo cmdlet non genera alcun output.

Note

Per usare questo cmdlet in Windows Vista o in una versione successiva del sistema operativo Windows, avviare Windows PowerShell usando l'opzione Esegui come amministratore.

Gli eventi, le sottoscrizioni di eventi e la coda degli eventi esistono solo nella sessione corrente. Se si chiude la sessione corrente, la coda degli eventi viene rimossa e la sottoscrizione dell'evento viene annullata.