__InstanceCreationEvent-Klasse
Die Systemklasse __InstanceCreationEventmeldet ein Ereignis zur Erstellung einer Instanz. Hierbei handelt es sich um ein systeminternes Ereignis, das beim Hinzufügen einer neuen Instanz zum Namespace generiert wird.
Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge aufgeführt, nicht in MOF-Reihenfolge.
Syntax
class __InstanceCreationEvent : __InstanceOperationEvent
{
uint8 SECURITY_DESCRIPTOR[];
object TargetInstance;
uint64 TIME_CREATED;
};
Member
Die Klasse __InstanceCreationEvent verfügt über folgende Membertypen:
Eigenschaften
Die Klasse __InstanceCreationEvent verfügt über folgende Eigenschaften.
-
SECURITY_DESCRIPTOR
-
-
Datentyp: uint8-Array
-
Zugriffstyp: Schreibgeschützt
Deskriptor, der vom Ereignisanbieter verwendet wird, um zu bestimmen, welche Benutzer*innen das Ereignis empfangen können. Diese Eigenschaft wird von _Event geerbt.
-
-
TargetInstance
-
-
Datentyp: object
-
Zugriffstyp: Schreibgeschützt
Kopie des erstellten Instanz. Diese Eigenschaft wird von __InstanceOperationEvent geerbt.
-
-
TIME_CREATED
-
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
Eindeutiger Wert, der den Zeitpunkt angibt, zu dem das Ereignis generiert wurde. Dies ist ein 64-Bit-Wert, der die Anzahl von 100-Nanosekunden-Intervallen seit dem 1. Januar 1601 darstellt. Diese Information wird im UTC-Format (koordinierte Weltzeit) angegeben. Diese Eigenschaft wird von _Event geerbt.
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
-
Bemerkungen
Die Klasse __InstanceCreationEvent wird von __InstanceOperationEvent abgeleitet.
Erstellen einer Ressource: __InstanceCreationEvent
Angenommen, Sie möchten eine Benachrichtigung erhalten, wenn der Editor auf einem bestimmten Computer ausgeführt wird. Wenn der Editor ausgeführt wird, wird ein entsprechender Prozess erstellt. Prozesse können mithilfe von WMI verwaltet werden und werden durch die „Win32_Process“-Klasse dargestellt. Wenn der Editor ausgeführt wird, wird eine entsprechende Instanz der „Win32_Process“-Klasse über WMI verfügbar gemacht. Wenn Sie Ihr Interesse an diesem Ereignis registriert haben (durch Ausgeben der entsprechenden Ereignisbenachrichtigungsabfrage), führt die Verfügbarkeit dieser Instanz zum Erstellen einer Instanz der __InstanceCreationEvent-Klasse.
Für Benachrichtigungsabfragen, die eine Benachrichtigung über das Erstellen einer Ressource anfordern und systeminterne Ereignisse verwenden, wird eine Syntax ähnlich der folgenden verwendet:
SELECT * FROM __InstanceCreationEvent WITHIN PollingInterval WHERE TargetInstance ISA 'Win32_Process' and TargetInstance.Name = 'notepad.exe'
Eine ausführlichere Erläuterung zur Verwendung der Klasse __InstanceCreationEvent zum Überwachen von Dateisystemen finden Sie unter WMI und Dateisystemüberwachung in CodeProject.
Beispiele
Im PowerShell-Beispiel Erstellen einer permanenten WMI-Ereignisregistrierung zum Überwachen von Dateien im TechNet-Katalog wird __InstanceCreationEvent als Teil eines komplexen Skripts verwendet, um eine permanente WMI-Ereignisregistrierung einzurichten.
Im PowerShell-Beispiel PowerShell und WMI – Permanente Ereignisse im TechNet-Katalog wird __InstanceCreationEvent als Teil eines Demonstrationsskripts zum Einrichten einer permanenten Ereignisregistrierung verwendet.
Im VBScript-Beispiel Überwachen von Prozesserstellungsereignissen in TechNet wird __InstanceCreationEvent verwendet, um das erste Ereignis zum Erstellen einer WMI-Instanz fürWin32_Process zu überwachen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
Alle WMI-Namespaces |