ConnectionOptions Classe

Definição

Especifica todas as configurações necessárias para estabelecer uma conexão 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
Herança
ConnectionOptions

Exemplos

O exemplo a seguir conecta-se a um computador remoto e exibe informações sobre o sistema operacional no computador remoto.The following example connects to a remote computer and displays information about the operating system on the remote computer. Um ConnectionOptions é criado para se conectar ao computador remoto com opções de conexão padrão.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

Construtores

ConnectionOptions()

Inicializa uma nova instância da classe ConnectionOptions para a operação de conexão, usando valores padrão.Initializes a new instance of the ConnectionOptions class for the connection operation, using default values. Esse é o construtor sem parâmetros.This is the parameterless constructor.

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

Cria uma nova ConnectionOption.Creates a new ConnectionOption.

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

Inicializa uma nova instância da classe ConnectionOptions a ser usada para uma conexão WMI, usando os valores especificados.Initializes a new instance of the ConnectionOptions class to be used for a WMI connection, using the specified values.

Propriedades

Authentication

Obtém ou define o nível de autenticação COM a ser usado para operações nesta conexão.Gets or sets the COM authentication level to be used for operations in this connection.

Authority

Obtém ou define a autoridade a ser usada para autenticar o usuário especificado.Gets or sets the authority to be used to authenticate the specified user.

Context

Obtém ou define um objeto de contexto WMI.Gets or sets a WMI context object. Essa é uma lista de pares nome-valor a ser passada para um provedor WMI que dá suporte a informações de contexto para a operação personalizada.This is a name-value pairs list to be passed through to a WMI provider that supports context information for customized operation.

(Herdado de ManagementOptions)
EnablePrivileges

Obtém ou define um valor que indica se os privilégios de usuário precisam ser habilitados para a operação de conexão.Gets or sets a value indicating whether user privileges need to be enabled for the connection operation. Essa propriedade só deve ser usada quando a operação executada requerer um determinado privilégio de usuário para ser habilitada (por exemplo, uma reinicialização do computador).This property should only be used when the operation performed requires a certain user privilege to be enabled (for example, a machine restart).

Impersonation

Obtém ou define o nível de representação COM a ser usado para operações nesta conexão.Gets or sets the COM impersonation level to be used for operations in this connection.

Locale

Obtém ou define a localidade a ser usada para a operação de conexão.Gets or sets the locale to be used for the connection operation.

Password

Define a senha do usuário especificado.Sets the password for the specified user.

SecurePassword

Define a senha do usuário especificado.Sets the password for the specified user.

Timeout

Obtém ou define o tempo limite para aplicar a operação.Gets or sets the time-out to apply to the operation. Observe que, para operações que retornam coleções, esse tempo limite se aplica à enumeração por meio da coleção resultante, não da operação propriamente dita (a propriedade ReturnImmediately é usada para a operação).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). Essa propriedade é usada para indicar que a operação deve ser realizada de forma semissíncrona.This property is used to indicate that the operation should be performed semi-synchronously.

(Herdado de ManagementOptions)
Username

Obtém ou define o nome de usuário a ser usado para a operação de conexão.Gets or sets the user name to be used for the connection operation.

Métodos

Clone()

Retorna uma cópia do objeto.Returns a copy of the object.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a