ManagementScope Klasse

Definition

Stellt einen Bereich (Namespace) für Verwaltungsvorgänge dar.

public ref class ManagementScope : ICloneable
[System.ComponentModel.TypeConverter(typeof(System.Management.ManagementScopeConverter))]
public class ManagementScope : ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Management.ManagementScopeConverter))>]
type ManagementScope = class
    interface ICloneable
Public Class ManagementScope
Implements ICloneable
Vererbung
ManagementScope
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird ein neues ManagementScope mit einem bestimmten Pfad initialisiert und anschließend das Bereichsobjekt mit einem WMI-Namespace verbunden. Im Beispiel wird eine Verbindung mit einem Namespace auf einem Remotecomputer hergestellt.

using System;
using System.Management;
public class RemoteConnect
{
    public static void Main()
    {
        /*// Build an options object for the remote connection
        //   if you plan to connect to the remote
        //   computer with a different user name
        //   and password than the one you are currently using

             ConnectionOptions options =
                 new ConnectionOptions();

             // and then set the options.Username and
             // options.Password properties to the correct values
             // and also set
             // options.Authority = "ntlmdomain:DOMAIN";
             // and replace DOMAIN with the remote computer's
             // domain.  You can also use Kerberos instead
             // of ntlmdomain.
        */

        // Make a connection to a remote computer.
        // Replace the "FullComputerName" section of the
        // string "\\\\FullComputerName\\root\\cimv2" with
        // the full computer name or IP address of the
        // remote computer.
        ManagementScope scope =
            new ManagementScope(
            "\\\\FullComputerName\\root\\cimv2");
        scope.Connect();

        // Use this code if you are connecting with a
        // different user name and password:
        //
        // ManagementScope scope =
        //    new ManagementScope(
        //        "\\\\FullComputerName\\root\\cimv2", options);
        // scope.Connect();

        //Query system for Operating System information
        ObjectQuery query = new ObjectQuery(
            "SELECT * FROM Win32_OperatingSystem");
        ManagementObjectSearcher searcher =
            new ManagementObjectSearcher(scope,query);

        ManagementObjectCollection queryCollection = searcher.Get();
        foreach ( ManagementObject m in queryCollection)
        {
            // Display the remote computer information
            Console.WriteLine("Computer Name : {0}",
                m["csname"]);
            Console.WriteLine("Windows Directory : {0}",
                m["WindowsDirectory"]);
            Console.WriteLine("Operating System: {0}",
                m["Caption"]);
            Console.WriteLine("Version: {0}", m["Version"]);
            Console.WriteLine("Manufacturer : {0}",
                m["Manufacturer"]);
        }
    }
}
Imports System.Management
Public Class RemoteConnect

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


        ' Build an options object for the remote connection
        ' if you plan to connect to the remote
        ' computer with a different user name
        ' and password than the one you are currently using

        ' Dim options As ConnectionOptions 
        ' options = new ConnectionOptions()

        ' Then set the options.Username and 
        ' options.Password properties to the correct values
        ' and also set 
        ' options.Authority = "ntlmdomain:DOMAIN"
        ' and replace DOMAIN with the remote computer's
        ' domain.  You can also use Kerberos instead
        ' of ntlmdomain.


        ' Make a connection to a remote computer.
        ' Replace the "FullComputerName" section of the
        ' string "\\FullComputerName\root\cimv2" with
        ' the full computer name or IP address of the
        ' remote computer.
        Dim scope As ManagementScope
        scope = New ManagementScope( _
            "\\FullComputerName\root\cimv2")
        scope.Connect()

        ' Use this code if you are connecting with a 
        ' different user name and password:
        '
        ' Dim scope As ManagementScope
        ' scope = New ManagementScope( _
        '     "\\FullComputerName\root\cimv2", options)
        ' scope.Connect()

        ' Query system for Operating System information
        Dim query As ObjectQuery
        query = New ObjectQuery( _
            "SELECT * FROM Win32_OperatingSystem")
        Dim searcher As ManagementObjectSearcher
        searcher = _
            New ManagementObjectSearcher(scope, query)

        Dim queryCollection As ManagementObjectCollection
        queryCollection = searcher.Get()

        Dim m As ManagementObject
        For Each m In queryCollection
            ' Display the remote computer information
            Console.WriteLine("Computer Name : {0}", _
                m("csname"))
            Console.WriteLine("Windows Directory : {0}", _
                m("WindowsDirectory"))
            Console.WriteLine("Operating System: {0}", _
                m("Caption"))
            Console.WriteLine("Version: {0}", m("Version"))
            Console.WriteLine("Manufacturer : {0}", _
                m("Manufacturer"))
        Next

        Return 0
    End Function
End Class

Konstruktoren

Name Beschreibung
ManagementScope()

Initialisiert eine neue Instanz der ManagementScope Klasse mit Standardwerten. Dies ist der parameterlose Konstruktor.

ManagementScope(ManagementPath, ConnectionOptions)

Initialisiert eine neue Instanz der ManagementScope Klasse, die den angegebenen Bereichspfad darstellt, mit den angegebenen Optionen.

ManagementScope(ManagementPath)

Initialisiert eine neue Instanz der ManagementScope Klasse, die den angegebenen Bereichspfad darstellt.

ManagementScope(String, ConnectionOptions)

Initialisiert eine neue Instanz der ManagementScope Klasse, die den angegebenen Bereichspfad darstellt, mit den angegebenen Optionen.

ManagementScope(String)

Initialisiert eine neue Instanz der ManagementScope Klasse, die den angegebenen Bereichspfad darstellt.

Eigenschaften

Name Beschreibung
IsConnected

Ruft einen Wert ab, der angibt, ob die ManagementScope derzeit an einen WMI-Server und namespace gebunden ist.

Options

Dient zum Abrufen oder Festlegen von Optionen zum Erstellen der WMI-Verbindung.

Path

Dient zum Abrufen oder Festlegen des Pfads für die ManagementScope.

Methoden

Name Beschreibung
Clone()

Gibt eine Kopie des Objekts zurück.

Connect()

Verbindet dies ManagementScope mit dem tatsächlichen WMI-Bereich.

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name Beschreibung
ICloneable.Clone()

Erstellt ein neues Objekt, das eine Kopie der aktuellen Instanz ist.

Gilt für: