ConnectionOptions Clase

Definición

Especifica toda la configuración necesaria para realizar una conexión WMI.

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

Ejemplos

En el ejemplo siguiente se conecta a un equipo remoto y se muestra información sobre el sistema operativo en el equipo remoto. ConnectionOptions Se crea para conectarse al equipo remoto con las opciones de conexión predeterminadas.

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

Constructores

ConnectionOptions()

Inicializa una nueva instancia de la clase ConnectionOptions para la operación de conexión utilizando los valores predeterminados. Este es el constructor sin parámetros.

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

Crea una nueva opción de conexión (ConnectionOption).

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

Inicializa una nueva instancia de la clase ConnectionOptions que se va a utilizar para una conexión WMI, mediante los valores especificados.

Propiedades

Authentication

Obtiene o establece el nivel de autenticación COM que se va a utilizar para las operaciones de esta conexión.

Authority

Obtiene o establece la autoridad que se utiliza para autenticar el usuario especificado.

Context

Obtiene o establece un objeto de contexto WMI. Se trata de una lista de pares de nombre y valor que se pasa a un proveedor WMI que admita información de contexto para las operaciones personalizadas.

(Heredado de ManagementOptions)
EnablePrivileges

Obtiene o establece un valor que indica si los privilegios de usuario necesitan habilitarse para la operación de conexión. Esta propiedad sólo debe usarse cuando la operación realizada requiere la habilitación de un determinado privilegio de usuario (por ejemplo, un reinicio de equipo).

Impersonation

Obtiene o establece el nivel de suplantación COM que se va a utilizar para las operaciones de esta conexión.

Locale

Obtiene o establece la configuración regional que se utiliza para la operación de conexión.

Password

Establece la contraseña del usuario especificado.

SecurePassword

Establece la contraseña del usuario especificado.

Timeout

Obtiene o establece el tiempo de espera que se aplicará a la operación. Observe que, en el caso de las operaciones que devuelvan colecciones, este tiempo de espera se aplica a la enumeración a través de la colección resultante y no a la operación en sí (para esta última se usa la propiedad ReturnImmediately). Esta propiedad se utiliza para indicar que la operación se debe realizar semisincrónicamente.

(Heredado de ManagementOptions)
Username

Obtiene o establece el nombre de usuario que se utiliza para la operación de conexión.

Métodos

Clone()

Devuelve una copia del objeto.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a