ManagementScope Klasse

Definition

Stellt einen Bereich (Namespace) für Verwaltungsoperationen dar.

public ref class ManagementScope : ICloneable
public class ManagementScope : ICloneable
[System.ComponentModel.TypeConverter(typeof(System.Management.ManagementScopeConverter))]
public class ManagementScope : ICloneable
type ManagementScope = class
    interface 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 eine neue ManagementScope mit einem bestimmten Pfad initialisiert und dann 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

ManagementScope()

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

ManagementScope(ManagementPath)

Initialisiert eine neue Instanz der ManagementScope-Klasse, die den angegebenen Gültigkeitsbereichspfad darstellt.

ManagementScope(ManagementPath, ConnectionOptions)

Initialisiert eine neue Instanz der ManagementScope-Klasse, die den angegebenen Gültigkeitsbereichspfad mit den angegebenen Optionen darstellt.

ManagementScope(String)

Initialisiert eine neue Instanz der ManagementScope-Klasse, die den angegebenen Gültigkeitsbereichspfad darstellt.

ManagementScope(String, ConnectionOptions)

Initialisiert eine neue Instanz der ManagementScope-Klasse, die den angegebenen Gültigkeitsbereichspfad mit den angegebenen Optionen darstellt.

Eigenschaften

IsConnected

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

Options

Ruft Optionen für das Herstellen der WMI-Verbindung ab oder legt diese fest.

Path

Ruft den Pfad für den ManagementScope ab oder legt diesen fest.

Methoden

Clone()

Gibt eine Kopie des Objekts zurück.

Connect()

Verbindet diesen ManagementScope mit dem eigentlichen WMI-Gültigkeitsbereich.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

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

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

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

Gilt für: