Freigeben über


ConnectionOptions Klasse

Definition

Gibt alle Einstellungen an, die zum Herstellen einer WMI-Verbindung erforderlich sind.

public ref class ConnectionOptions : System::Management::ManagementOptions
public class ConnectionOptions : System.Management.ManagementOptions
type ConnectionOptions = class
    inherit ManagementOptions
Public Class ConnectionOptions
Inherits ManagementOptions
Vererbung
ConnectionOptions

Beispiele

Das folgende Beispiel stellt eine Verbindung mit einem Remotecomputer her und zeigt Informationen zum Betriebssystem auf dem Remotecomputer an. Ein ConnectionOptions wird erstellt, um eine Verbindung mit dem Remotecomputer mit Standardverbindungsoptionen herzustellen.

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.
        // This example uses the default values.

        ConnectionOptions options =
            new ConnectionOptions();

        // 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", 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

        ' 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", 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

ConnectionOptions()

Initialisiert eine neue Instanz der ConnectionOptions-Klasse für die Verbindungsoperation mit Standardwerten. Dies ist der parameterlose Konstruktor.

ConnectionOptions(String, String, SecureString, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan)

Erstellt eine neue ConnectionOption.

ConnectionOptions(String, String, String, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan)

Initialisiert eine neue Instanz der ConnectionOptions-Klasse zur Verwendung mit einer WMI-Verbindung mit den angegebenen Werten.

Eigenschaften

Authentication

Ruft die für Operationen in dieser Verbindung zu verwendende COM-Authentifizierungsebene ab oder legt diese fest.

Authority

Ruft die für die Authentifizierung des angegebenen Benutzers zu verwendende Autorität ab oder legt diese fest.

Context

Ruft ein WMI-Kontextobjekt ab oder legt dieses fest. Dies ist eine Liste von Name-Wert-Paaren, die zur Übergabe an einen WMI-Anbieter bestimmt ist, der Kontextinformationen für benutzerdefinierte Operationen unterstützt.

(Geerbt von ManagementOptions)
EnablePrivileges

Ruft einen Wert ab, der angibt, ob Benutzerberechtigungen für die Verbindungsoperation aktiviert werden müssen, oder legt diesen fest. Diese Eigenschaft darf nur verwendet werden, wenn für die durchzuführende Operation die Aktivierung einer bestimmten Benutzerberechtigung erforderlich ist (z. B. ein Neustart des Computers).

Impersonation

Ruft die für Operationen in dieser Verbindung zu verwendende Ebene des COM-Identitätswechsels ab oder legt diese fest.

Locale

Ruft das für die Verbindungsoperation zu verwendende Gebietsschema ab oder legt dieses fest.

Password

Legt das Kennwort für den angegebenen Benutzer fest.

SecurePassword

Legt das Kennwort für den angegebenen Benutzer fest.

Timeout

Ruft das für die Operation geltende Timeout ab oder legt dieses fest. Beachten Sie Folgendes: Dieses Timeout gilt bei Operationen, die Auflistungen zurückgeben, für die Enumeration der resultierenden Auflistung, aber nicht für die eigentliche Operation (die ReturnImmediately-Eigenschaft wird für die eigentliche Operation verwendet). Mit dieser Eigenschaft wird angegeben, dass die Operation halbsynchron durchzuführen ist.

(Geerbt von ManagementOptions)
Username

Ruft den für die Verbindungsoperation zu verwendenden Benutzernamen ab oder legt diesen fest.

Methoden

Clone()

Gibt eine Kopie des Objekts zurück.

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)

Gilt für: