ConnectionOptions ConnectionOptions ConnectionOptions ConnectionOptions Class

定義

WMI (Windows Management Instrumentation) 接続を確立するために必要なすべての設定を指定します。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
継承
ConnectionOptionsConnectionOptionsConnectionOptionsConnectionOptions

次の例では、リモートコンピューターに接続し、リモートコンピューターのオペレーティングシステムに関する情報を表示します。The following example connects to a remote computer and displays information about the operating system on the remote computer. 既定ConnectionOptionsの接続オプションを使用してリモートコンピューターに接続するためのが作成されます。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
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

コンストラクター

ConnectionOptions() ConnectionOptions() ConnectionOptions() ConnectionOptions()

接続操作のための ConnectionOptions クラスの新しいインスタンスを、既定値を使用して初期化します。Initializes a new instance of the ConnectionOptions class for the connection operation, using default values. これはパラメーターなしのコンストラクターです。This is the parameterless constructor.

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

新しい接続オプションを作成します。Creates a new ConnectionOption.

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

指定した値を使用して、WMI 接続に使用する ConnectionOptions クラスの新しいインスタンスを初期化します。Initializes a new instance of the ConnectionOptions class to be used for a WMI connection, using the specified values.

プロパティ

Authentication Authentication Authentication Authentication

この接続の操作に使用する COM 認証レベルを取得または設定します。Gets or sets the COM authentication level to be used for operations in this connection.

Authority Authority Authority Authority

指定したユーザーを認証するために使用する証明機関を取得または設定します。Gets or sets the authority to be used to authenticate the specified user.

Context Context Context Context

WMI (Windows Management Instrumentation) コンテキスト オブジェクトを取得または設定します。Gets or sets a WMI context object. これは、カスタマイズされた操作のためのコンテキスト情報をサポートしている WMI プロバイダーに渡す名前/値ペア リストです。This is a name-value pairs list to be passed through to a WMI provider that supports context information for customized operation.

(Inherited from ManagementOptions)
EnablePrivileges EnablePrivileges EnablePrivileges EnablePrivileges

接続操作のためにユーザー特権を有効にする必要があるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether user privileges need to be enabled for the connection operation. このプロパティは、操作 (コンピューターの再起動など) を実行するために特定のユーザー特権を有効にする必要がある場合にだけ使用してください。This property should only be used when the operation performed requires a certain user privilege to be enabled (for example, a machine restart).

Impersonation Impersonation Impersonation Impersonation

この接続の操作に使用する COM 偽装レベルを取得または設定します。Gets or sets the COM impersonation level to be used for operations in this connection.

Locale Locale Locale Locale

接続操作に使用するロケールを取得または設定します。Gets or sets the locale to be used for the connection operation.

Password Password Password Password

指定したユーザーのパスワードを設定します。Sets the password for the specified user.

SecurePassword SecurePassword SecurePassword SecurePassword

指定したユーザーのパスワードを設定します。Sets the password for the specified user.

Timeout Timeout Timeout Timeout

操作に適用するタイムアウトを取得または設定します。Gets or sets the time-out to apply to the operation. コレクションを返す操作では、このタイムアウトはその操作自体ではなく、結果として得られるコレクションの列挙に適用されます。操作自体に適用するには、ReturnImmediately プロパティを使用します。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). このプロパティは、操作が半同期的に実行されることを示すために使用されます。This property is used to indicate that the operation should be performed semi-synchronously.

(Inherited from ManagementOptions)
Username Username Username Username

接続操作に使用するユーザー名を取得または設定します。Gets or sets the user name to be used for the connection operation.

メソッド

Clone() Clone() Clone() Clone()

オブジェクトのコピーを返します。Returns a copy of the object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象