ControlMetrics-Methode der Msvm_MetricService-Klasse
Wird verwendet, um die Sammlung von Metriken für ein oder mehrere verwaltete Elemente zu steuern.
Syntax
uint32 ControlMetrics(
[in] CIM_ManagedElement REF Subject,
[in] CIM_BaseMetricDefinition REF Definition,
[in] uint16 MetricCollectionEnabled
);
Parameter
-
Betreff [in]
-
Eine CIM_ManagedElement instance, die die verwalteten Elemente identifiziert, für die Metriken gesammelt werden. Wenn dieser Parameter Null ist, werden die Metriken für alle verwalteten Elemente gesammelt, die dem Definition-Parameter zugeordnet sind.
-
Definition [in]
-
Eine Msvm_BaseMetricDefinition instance, die angibt, welche Metriken erfasst werden sollen. Wenn dieser Parameter Null ist, werden die Metriken für alle Definitionen gesammelt, die dem verwalteten Element zugeordnet sind, das durch den Subject-Parameter identifiziert wird.
-
MetricCollectionEnabled [in]
-
Gibt den Vorgang an, der für die Metriksammlung ausgeführt werden soll. Dies muss einer der folgenden Werte sein.
-
Aktivieren (2)
-
Aktivieren sie die Metriksammlung.
-
Deaktivieren (3)
-
Deaktivieren sie die Metriksammlung.
-
Zurücksetzen (4)
-
Setzen Sie Metrikwerte zurück.
-
DMTF Reserviert (..)
-
Anbieter reserviert (32768..65535)
Rückgabewert
Diese Methode gibt einen der folgenden Werte zurück.
-
Erfolg (0)
-
Nicht unterstützt (1)
-
Fehler (2)
-
Reservierte Methode (..)
-
Herstellerspezifisch (32768..65535)
Bemerkungen
Diese Methode schlägt in den folgenden Instanzen fehl:
- Die Parameter Subject und Definition sind beide NULL.
- Die Parameter Subject und Definition sind beide ungleich Null, und es gibt keine instance von Msvm_MetricDefForME, die den beiden Instanzen zuordnet.
- Der Definition-Parameter ist ein Verweis auf eine instance von Msvm_BaseMetricDefinition, die dem Msvm_MetricService über Msvm_ServiceAffectsElement nicht zugeordnet ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 [nur Desktop-Apps] |
| Namespace |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|