ConnectionOptions-Konstruktor (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.

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

Syntax

'Declaration
Public Sub New ( _
    locale As String, _
    username As String, _
    password As String, _
    authority As String, _
    impersonation As ImpersonationLevel, _
    authentication As AuthenticationLevel, _
    enablePrivileges As Boolean, _
    context As ManagementNamedValueCollection, _
    timeout As TimeSpan _
)
'Usage
Dim locale As String
Dim username As String
Dim password As String
Dim authority As String
Dim impersonation As ImpersonationLevel
Dim authentication As AuthenticationLevel
Dim enablePrivileges As Boolean
Dim context As ManagementNamedValueCollection
Dim timeout As TimeSpan

Dim instance As New ConnectionOptions(locale, username, password, authority, impersonation, authentication, enablePrivileges, context, timeout)

public ConnectionOptions (
    string locale,
    string username,
    string password,
    string authority,
    ImpersonationLevel impersonation,
    AuthenticationLevel authentication,
    bool enablePrivileges,
    ManagementNamedValueCollection context,
    TimeSpan timeout
)

public:
ConnectionOptions (
    String^ locale, 
    String^ username, 
    String^ password, 
    String^ authority, 
    ImpersonationLevel impersonation, 
    AuthenticationLevel authentication, 
    bool enablePrivileges, 
    ManagementNamedValueCollection^ context, 
    TimeSpan timeout
)

public ConnectionOptions (
    String locale, 
    String username, 
    String password, 
    String authority, 
    ImpersonationLevel impersonation, 
    AuthenticationLevel authentication, 
    boolean enablePrivileges, 
    ManagementNamedValueCollection context, 
    TimeSpan timeout
)

public function ConnectionOptions (
    locale : String, 
    username : String, 
    password : String, 
    authority : String, 
    impersonation : ImpersonationLevel, 
    authentication : AuthenticationLevel, 
    enablePrivileges : boolean, 
    context : ManagementNamedValueCollection, 
    timeout : TimeSpan
)

Parameter

locale
Das für die Verbindung zu verwendende Gebietsschema.

username
Der für die Verbindung zu verwendende Benutzername. Bei NULL werden die Anmeldeinformationen des momentan angemeldeten Benutzers verwendet.

password
Das Kennwort für den angegebenen Benutzernamen. Wenn der Benutzername ebenfalls NULL ist, werden die Anmeldeinformationen des momentan angemeldeten Benutzers verwendet.

authority
Die für die Authentifizierung des angegebenen Benutzers zu verwendende Autorität.

impersonation
Die für die Verbindung zu verwendende Ebene des COM-Identitätswechsels.

authentication
Die für die Verbindung zu verwendende COM-Authentifizierungsebene.

enablePrivileges
true, um spezielle Benutzerberechtigungen zu aktivieren, andernfalls false. Dieser Parameter darf nur beim Ausführen einer Operation verwendet werden, für die spezielle Windows NT-Benutzerberechtigungen erforderlich sind.

context
Ein providerspezifisches Objekt von benannten Wertpaaren, das durch den Provider weitergegeben werden soll.

timeout
Für zukünftige Verwendung reserviert.

Beispiel

Im folgenden Beispiel wird eine Verbindung mit einem Remotecomputer hergestellt, und es werden Informationen über das Betriebssystem auf dem Remotecomputer angezeigt. ConnectionOptions wird erstellt, um eine Verbindung mit dem Remotecomputer mit den gewünschten Verbindungsoptionen herzustellen.

Imports System
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.
        ' This example does not hard-code a password.  You need to pass
        ' in a password variable with the correct value or set it
        ' the value of the password property later.

       Dim options As ConnectionOptions
       options = New ConnectionOptions("MS_409", "userName", Nothing, _
            "ntdlmdomain:DOMAIN", _
            System.Management.ImpersonationLevel.Impersonate, _
            System.Management.AuthenticationLevel.Default, True, _
            Nothing, System.TimeSpan.MaxValue)

        ' 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

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 does not hard-code a password.  You need to pass
        // in a password variable with the correct value or set it
        // the value of the password property later.

        ConnectionOptions options = 
            new ConnectionOptions("MS_409", "userName", null, 
            "ntdlmdomain:DOMAIN", 
            System.Management.ImpersonationLevel.Impersonate,
            System.Management.AuthenticationLevel.Default, true,
            null, System.TimeSpan.MaxValue);

        // 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"]);
        }
    }
}

.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

ConnectionOptions-Klasse
ConnectionOptions-Member
System.Management-Namespace

Last updated on 2007-08-20

Freigeben über