ConnectionOptions Klasa

Definicja

Określa wszystkie ustawienia wymagane do nawiązania połączenia z usługą WMI.Specifies all settings required to make a WMI connection.

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

Przykłady

Poniższy przykład nawiązuje połączenie z komputerem zdalnym i wyświetla informacje o systemie operacyjnym na komputerze zdalnym.The following example connects to a remote computer and displays information about the operating system on the remote computer. ConnectionOptions Jest tworzony w celu nawiązania połączenia z komputerem zdalnym z domyślnymi opcjami połączenia.A ConnectionOptions is created to connect to the remote computer with default connection options.

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

Konstruktory

ConnectionOptions()

Inicjuje nowe wystąpienie ConnectionOptions klasy dla operacji połączenia przy użyciu wartości domyślnych.Initializes a new instance of the ConnectionOptions class for the connection operation, using default values. To jest Konstruktor bez parametrów.This is the parameterless constructor.

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

Tworzy nowy ConnectionOption.Creates a new ConnectionOption.

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

Inicjuje nowe wystąpienie ConnectionOptions klasy, które ma być używane dla połączenia WMI przy użyciu określonych wartości.Initializes a new instance of the ConnectionOptions class to be used for a WMI connection, using the specified values.

Właściwości

Authentication

Pobiera lub ustawia poziom uwierzytelniania COM, który ma być używany dla operacji w ramach tego połączenia.Gets or sets the COM authentication level to be used for operations in this connection.

Authority

Pobiera lub ustawia urząd do użycia w celu uwierzytelnienia określonego użytkownika.Gets or sets the authority to be used to authenticate the specified user.

Context

Pobiera lub ustawia obiekt kontekstu WMI.Gets or sets a WMI context object. Jest to lista par nazwa-wartość, która ma zostać przeniesiona do dostawcy WMI, który obsługuje informacje kontekstu dla niestandardowej operacji.This is a name-value pairs list to be passed through to a WMI provider that supports context information for customized operation.

(Odziedziczone po ManagementOptions)
EnablePrivileges

Pobiera lub ustawia wartość wskazującą, czy uprawnienia użytkownika muszą być włączone dla operacji połączenia.Gets or sets a value indicating whether user privileges need to be enabled for the connection operation. Ta właściwość powinna być używana tylko wtedy, gdy wykonywana operacja wymaga włączenia określonego uprawnienia użytkownika (na przykład ponownego uruchomienia komputera).This property should only be used when the operation performed requires a certain user privilege to be enabled (for example, a machine restart).

Impersonation

Pobiera lub ustawia poziom personifikacji COM, który ma być używany dla operacji w ramach tego połączenia.Gets or sets the COM impersonation level to be used for operations in this connection.

Locale

Pobiera lub ustawia ustawienia regionalne, które mają być używane dla operacji połączenia.Gets or sets the locale to be used for the connection operation.

Password

Ustawia hasło dla określonego użytkownika.Sets the password for the specified user.

SecurePassword

Ustawia hasło dla określonego użytkownika.Sets the password for the specified user.

Timeout

Pobiera lub ustawia limit czasu, który ma zostać zastosowany do operacji.Gets or sets the time-out to apply to the operation. Należy pamiętać, że w przypadku operacji, które zwracają kolekcje, ten limit czasu ma zastosowanie do wyliczenia za pomocą wynikowej kolekcji, a nie ReturnImmediately samej operacji (właściwość jest używana dla tej ostatniej).Note that for operations that return collections, this time-out applies to the enumeration through the resulting collection, not the operation itself (the ReturnImmediately property is used for the latter). Ta właściwość służy do wskazywania, że operacja powinna zostać wykonana częściowo synchronicznie.This property is used to indicate that the operation should be performed semi-synchronously.

(Odziedziczone po ManagementOptions)
Username

Pobiera lub ustawia nazwę użytkownika, która będzie używana dla operacji połączenia.Gets or sets the user name to be used for the connection operation.

Metody

Clone()

Zwraca kopię obiektu.Returns a copy of the object.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy