ManagementScope Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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. |