ManagementObject-Konstruktor (ManagementScope, ManagementPath, ObjectGetOptions)

Initialisiert eine neue Instanz der ManagementObject-Klasse, die an den angegebenen WMI-Pfad gebunden ist und die angegebenen Optionen einschließt.

Namespace: System.Management
Assembly: System.Management (in system.management.dll)

Syntax

'Declaration
Public Sub New ( _
    scope As ManagementScope, _
    path As ManagementPath, _
    options As ObjectGetOptions _
)
'Usage
Dim scope As ManagementScope
Dim path As ManagementPath
Dim options As ObjectGetOptions

Dim instance As New ManagementObject(scope, path, options)

public ManagementObject (
    ManagementScope scope,
    ManagementPath path,
    ObjectGetOptions options
)

public:
ManagementObject (
    ManagementScope^ scope, 
    ManagementPath^ path, 
    ObjectGetOptions^ options
)

public ManagementObject (
    ManagementScope scope, 
    ManagementPath path, 
    ObjectGetOptions options
)

public function ManagementObject (
    scope : ManagementScope, 
    path : ManagementPath, 
    options : ObjectGetOptions
)

Parameter

• scope
  Ein ManagementScope, der den Gültigkeitsbereich darstellt, in dem sich das WMI-Objekt befindet. In dieser Version darf es sich bei Gültigkeitsbereichen nur um WMI-Namespaces handeln.

• path
  Ein ManagementPath, der den WMI-Pfad des zu verwaltenden Objekts darstellt.

• options
  Ein ObjectGetOptions, das zusätzliche Optionen zum Abrufen des Objekts angibt.

Hinweise

Da WMI-Pfade relativ oder vollständig sein können, kann ein Konflikt zwischen dem Gültigkeitsbereich und dem angegebenem Pfad auftreten. Wenn jedoch ein Gültigkeitsbereich und ein relativer WMI-Pfad angegeben wird, entsteht kein Konflikt. Im Folgenden sind einige potenzielle Konflikte aufgelistet:

Wenn kein Gültigkeitsbereich, aber ein relativer WMI-Pfad angegeben ist, wird die Standardeinstellung für den Gültigkeitsbereich übernommen und dieser auf den DefaultPath festgelegt.

Wenn kein Gültigkeitsbereich, aber ein vollständiger WMI-Pfad angegeben ist, wird der Gültigkeitsbereich aus dem Gültigkeitsbereichsabschnitt des vollständigen Pfads hergeleitet. Beispiel: Der vollständige WMI-Pfad \\MyMachine\root\MyNamespace:MyClass.Name='abc' stellt das WMI-Objekt "MyClass.Name='abc'" im Gültigkeitsbereich "\\MyMachine\root\MyNamespace" dar.

Wenn ein Gültigkeitsbereich und ein vollständiger WMI-Pfad angegeben sind, überschreibt der Gültigkeitsbereich den Gültigkeitsbereichsabschnitt des vollständigen Pfads. Beispiel: Wenn der Gültigkeitsbereich \\MyMachine\root\MyScope und der vollständige Pfad \\MyMachine\root\MyNamespace:MyClass.Name='abc' angegeben wurden, suchen Sie nach object: \\MyMachine\root\MyScope:MyClass.Name= 'abc' (der Gültigkeitsbereichsteil des vollständigen Pfads wird ignoriert).

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Beispiel

Im folgenden Beispiel wird eine neue Instanz der ManagementObject-Klasse initialisiert, die an einen bestimmten WMI-Objektpfad gebunden ist.

Imports System
Imports System.Management

Class Sample_ManagementClass
    Public Overloads Shared Function Main( _
        ByVal args() As String) As Integer

        Dim s As New ManagementScope( _
            "\\MyMachine\root\cimv2")
        Dim p As New ManagementPath( _
            "Win32_Service")

        ' Set options for no context info,
        ' but requests amended qualifiers 
        ' to be contained in the object
        Dim opt As ObjectGetOptions
        opt = New ObjectGetOptions( _
                Nothing, TimeSpan.MaxValue, True)

        Dim o As ManagementObject
        o = New ManagementObject(s, p, opt)

        Console.WriteLine(o.Qualifiers("Description").Value)

        Return 0
    End Function
End Class

using System;
using System.Management;
   
class Sample
{
    public static int Main(string[] args) 
    {
        ManagementScope s = new ManagementScope(
            "\\\\MyMachine\\root\\cimv2");
        ManagementPath p = 
            new ManagementPath(
            "Win32_Service");

        // Set options for no context info,
        // but requests amended qualifiers 
        // to be contained in the object
        ObjectGetOptions opt = 
            new ObjectGetOptions(
            null, TimeSpan.MaxValue, true); 

        ManagementObject o = new ManagementObject(s, p, opt);

        Console.WriteLine(o.Qualifiers["Description"].Value);

        return 0;
    }
}

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ManagementObject-Klasse
ManagementObject-Member
System.Management-Namespace