ConnectionOptions Clase

Definición

Espacio de nombres:

System.Management

Ensamblado:

System.Management.dll

Especifica todas las opciones necesarias 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

Object

ManagementOptions

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 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

Nombre	Description
ConnectionOptions()	Inicializa una nueva instancia de la ConnectionOptions clase para la operación de conexión mediante valores predeterminados. Este es el constructor sin parámetros.
ConnectionOptions(String, String, SecureString, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan)	Crea una nueva ConnectionOption.
ConnectionOptions(String, String, String, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan)	Inicializa una nueva instancia de la ConnectionOptions clase que se va a usar para una conexión WMI mediante los valores especificados.

Propiedades

Nombre	Description
Authentication	Obtiene o establece el nivel de autenticación COM que se usará para las operaciones de esta conexión.
Authority	Obtiene o establece la autoridad que se va a usar para autenticar al usuario especificado.
Context	Obtiene o establece un objeto de contexto WMI. Se trata de una lista de pares de nombre-valor que se pasarán a un proveedor WMI que admite información de contexto para la operación personalizada. (Heredado de ManagementOptions)
EnablePrivileges	Obtiene o establece un valor que indica si los privilegios de usuario deben habilitarse para la operación de conexión. Esta propiedad solo se debe usar cuando la operación realizada requiere que se habilite un determinado privilegio de usuario (por ejemplo, un reinicio de la máquina).
Impersonation	Obtiene o establece el nivel de suplantación COM que se usará para las operaciones de esta conexión.
Locale	Obtiene o establece la configuración regional que se va a usar 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. Tenga en cuenta que para las operaciones que devuelven colecciones, este tiempo de espera se aplica a la enumeración a través de la colección resultante, no a la propia operación (la ReturnImmediately propiedad se usa para este último). Esta propiedad se usa para indicar que la operación se debe realizar de forma semiincrónica. (Heredado de ManagementOptions)
Username	Obtiene o establece el nombre de usuario que se va a usar para la operación de conexión.

Métodos

Nombre	Description
Clone()	Devuelve una copia del objeto .
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa 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 Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)