Register-CimIndicationEvent
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 rendszergazdaként kell futtatnia a PowerShellt.
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.
Típus: | ScriptBlock |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | CimSession |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Aliasok: | CN, ServerName |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Int32 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | PSObject |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | UInt32 |
Aliasok: | OT |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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 [
.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | WQL |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
Ez a parancsmag egy EventSubscription objektumot ad vissza.
Jegyzetek
A PowerShell a következő aliasokat Register-CimIndicationEvent
tartalmazza:
- Windows:
rcie
Ez a parancsmag csak Windows-platformokon érhető el.