ConnectionOptions Classe

Définition

Espace de noms:

System.Management

Assembly:

System.Management.dll

Paquet:

System.Management v8.0.0

Source:

ManagementOptions.cs

Spécifie tous les paramètres requis pour créer une connexion WMI.

public ref class ConnectionOptions : System::Management::ManagementOptions

public class ConnectionOptions : System.Management.ManagementOptions

type ConnectionOptions = class
    inherit ManagementOptions

Public Class ConnectionOptions
Inherits ManagementOptions

Héritage

Object

ManagementOptions

ConnectionOptions

Exemples

L’exemple suivant se connecte à un ordinateur distant et affiche des informations sur le système d’exploitation sur l’ordinateur distant. Un ConnectionOptions est créé pour se connecter à l’ordinateur distant avec les options de connexion par défaut.

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

Constructeurs

ConnectionOptions()	Initialise une nouvelle instance de la classe ConnectionOptions pour l'opération de connexion, en utilisant les valeurs par défaut. Il s’agit du constructeur sans paramètre.
ConnectionOptions(String, String, SecureString, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan)	Crée un ConnectionOption.
ConnectionOptions(String, String, String, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan)	Initialise une nouvelle instance de la classe ConnectionOptions à utiliser pour une connexion WMI, en utilisant les valeurs spécifiées.

Propriétés

Authentication	Obtient ou définit le niveau d'authentification COM à utiliser pour les opérations au cours de cette connexion.
Authority	Obtient ou définit l'autorité à utiliser pour authentifier l'utilisateur spécifié.
Context	Obtient ou définit un objet de contexte WMI. Il s'agit d'une liste de paires nom-valeur à passer à un fournisseur WMI qui prend en charge les informations de contexte pour une opération personnalisée. (Hérité de ManagementOptions)
EnablePrivileges	Obtient ou définit une valeur indiquant si les privilèges utilisateur doivent être activés pour l'opération de connexion. Cette propriété ne doit être utilisée que si l'opération effectuée requiert qu'un certain privilège utilisateur soit activé (un redémarrage de l'ordinateur, par exemple).
Impersonation	Obtient ou définit le niveau d'emprunt d'identité COM à utiliser pour les opérations au cours de cette connexion.
Locale	Obtient ou définit les paramètres régionaux à utiliser pour l'opération de connexion.
Password	Permet de définir le mot de passe de l'utilisateur spécifié.
SecurePassword	Permet de définir le mot de passe de l'utilisateur spécifié.
Timeout	Obtient ou définit le délai d'attente à appliquer à l'opération. Notez que pour les opérations qui retournent des collections, ce délai d'attente s'applique à l'énumération sur la collection résultante, et non sur l'opération elle-même (la propriété ReturnImmediately est utilisée pour cette dernière). Cette propriété est utilisée pour indiquer que l'opération doit être effectuée de façon semi-synchrone. (Hérité de ManagementOptions)
Username	Obtient ou définit le nom d'utilisateur à utiliser pour l'opération de connexion.

Méthodes

Clone()	Retourne une copie de l'objet.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)