Share via

Register-CimIndicationEvent

  • Referencia
Modul:
CimCmdlets

Szűrőkifejezéssel vagy lekérdezési kifejezéssel előfizet a jelzésekre.

Syntax

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>]

Description

Ez a parancsmag csak a Windows platformon érhető el.

A Register-CimIndicationEvent parancsmag egy indikációs osztálynévvel vagy lekérdezési kifejezéssel feliratkozik az indikációkra. A SourceIdentifier paraméterrel adjon nevet az előfizetésnek.

Ez a parancsmag egy EventSubscription objektumot ad vissza. Ezzel az objektummal lemondhatja az előfizetést.

Példák

1. példa: Az osztály által létrehozott események regisztrálása

Ez a példa feliratkozik a Win32_ProcessStartTrace nevű osztály által létrehozott eseményekre. Ez az osztály eseményt hoz létre, amikor egy folyamat elindul.

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

A Get-Event parancsmag a ProcessStarted-előfizetéssel kapja meg az eseményeket. További információ: Get-Event.

Feljegyzés

Ebben a példában a PowerShellt Rendszergazda istratorként kell futtatnia.

2. példa: Események regisztrálása lekérdezéssel

Ez a példa egy lekérdezéssel előfizet egy eseményre, amely akkor jön létre, amikor változás történik egy Win32_LocalTime nevű osztály példányában.

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

3. példa: Szkript futtatása az esemény érkezésekor

Ez a példa bemutatja, hogyan használhat egy műveletet egy eseményre válaszul. A változó $action tartalmazza a Művelet szkriptblokkját, amely a $event változót használja a CIM-től kapott esemény eléréséhez.

$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

További információ: Win32_ProcessStartTrace.

4. példa: Események regisztrálása távoli számítógépen

Ez a példa előfizet egy Server01 nevű távoli számítógépen lévő eseményekre. A CIM-kiszolgálótól kapott események az aktuális PowerShell-munkamenet eseménysorában vannak tárolva, majd egy helyi Get-Event futtatáson futnak az események lekéréséhez.

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

Paraméterek

-Action

Megadja az eseményeket kezelő parancsokat. A paraméter által megadott parancsok esemény létrehozásakor futnak, ahelyett, hogy az eseményt az eseménysorba küldik. A parancsokat kapcsos zárójelekbe ({}) ágyazva hozzon létre egy szkriptblokkot.

A Művelettel megadott szkriptblokk tartalmazhat a $Event, $EventSubscriber, $Sender, $SourceEventArgs, és $SourceArgs automatikus változókat, amelyek információt nyújtanak az eseményről a Művelet szkriptblokknak. További információt az Automatikus változók című témakörben talál.

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

-CimSession

A parancsot a megadott CIM-munkamenet használatával futtatja. Adjon meg egy változót, amely tartalmazza a CIM-munkamenetet, vagy egy parancsot, amely létrehozza vagy lekéri a CIM-munkamenetet, például a New-CimSession parancsmagokat.Get-CimSession További információ: about_CimSession.

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

-ClassName

Megadja azt a jelzési osztályt, amelyre feliratkozik. A tabulátorkiegészítéssel tallózhat az osztályok listájában, mivel a PowerShell lekéri a helyi WMI-kiszolgálóról az osztályok listáját az osztálynevek listájának megadásához.

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

-ComputerName

Megadja annak a számítógépnek a nevét, amelyen futtatni szeretné a CIM-műveletet. Megadhat teljes tartománynevet (FQDN), NetBIOS-nevet vagy IP-címet.

Ha megadja ezt a paramétert, a parancsmag létrehoz egy ideiglenes munkamenetet a megadott számítógépen a WsMan protokoll használatával. Ha nem adja meg ezt a paramétert, a parancsmag műveletet hajt végre a helyi rendszeren a Component Object Model (COM) használatával.

Ha több műveletet végez ugyanazon a számítógépen, csatlakozzon egy CIM-munkamenet használatával a jobb teljesítmény érdekében.

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

-Forward

Azt jelzi, hogy az előfizetés eseményei a helyi számítógépen lévő munkamenetbe lesznek továbbítva. Ezt a paramétert akkor használja, ha távoli számítógépen vagy távoli munkamenetben regisztrál eseményekre.

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

-MaxTriggerCount

Paraméter, amely azt jelzi, hogy az előfizetőnek automatikusan regisztrálnia kell a regisztrációt a megadott időpontokra való aktiválás után. Ha az érték nullánál egyenlő vagy kisebb, nincs korlátozva, hogy az esemény hányszor aktiválható regisztráció nélkül.

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

-MessageData

Megadja az esemény-előfizetéshez társítandó további adatokat. Ennek a paraméternek az értéke az előfizetéshez társított összes esemény MessageData tulajdonságában jelenik meg.

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

-Namespace

Megadja a CIM-művelet névterét. Az alapértelmezett névtér a root/cimv2. A tabulátorkiegészítéssel tallózhat a névterek listájában, mivel a PowerShell lekéri a névterek listáját a helyi WMI-kiszolgálóról a névterek listájának megadásához.

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

-OperationTimeoutSec

Megadja, hogy a parancsmag mennyi időt vár a számítógép válaszára. Alapértelmezés szerint ennek a paraméternek az értéke 0, ami azt jelenti, hogy a parancsmag a kiszolgáló alapértelmezett időtúllépési értékét használja.

Ha az OperationTimeoutSec paraméter értéke kisebb, mint a robusztus kapcsolat újrapróbálkozási időtúllépése 3 perc, akkor az OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre, mert a kiszolgálón végzett művelet túllépi az időkorlátot, mielőtt az ügyfél újracsatlakozhat.

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

-Query

A CIM-kiszolgálón futtatandó lekérdezést adja meg. Ha a megadott érték dupla idézőjeleket ", egyszeri idézőjeleket 'vagy fordított perjeleket \tartalmaz, ezeket a karaktereket a fordított perjel karakterrel való előtagolásával kell feloldani. Ha a megadott érték a WQL LIKE operátort használja, akkor a következő karaktereket el kell hárítania, ha szögletes zárójelekbe []foglalja őket: százalék %, aláhúzás _vagy nyitó szögletes zárójel [.

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

-QueryDialect

A Lekérdezés paraméterhez használt lekérdezési nyelvet adja meg. A paraméter elfogadható értékei a következők: WQL vagy CQL. Az alapértelmezett érték a WQL.

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

-SourceIdentifier

Megadja az előfizetés nevét. A megadott névnek egyedinek kell lennie az aktuális munkamenetben. Az alapértelmezett érték a PowerShell által hozzárendelt GUID. Ez az érték az előfizető objektum SourceIdentifier tulajdonságának és az előfizetéshez társított összes eseményobjektumnak az értékében jelenik meg.

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

-SupportEvent

Azt jelzi, hogy az esemény-előfizetés rejtett. Ezt a paramétert akkor használja, ha az aktuális előfizetés egy összetettebb eseményregisztrációs mechanizmus része, és nem szabad egymástól függetlenül felderíteni.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

Object

Ez a parancsmag egy EventSubscription objektumot ad vissza.

Jegyzetek

A PowerShell a következő aliasokat Register-CimIndicationEventtartalmazza:

  • Windows:
    • rcie

Ez a parancsmag csak Windows-platformokon érhető el.