ConnectionOptionsとは? わかりやすく解説

ConnectionOptions クラス

WMI (Windows Management Instrumentation) 接続を確立するために必要なすべての設定を指定します。

名前空間: System.Management
アセンブリ: System.Management (system.management.dll 内)
構文構文

Public Class ConnectionOptions
    Inherits ManagementOptions
Dim instance As ConnectionOptions
public class ConnectionOptions : ManagementOptions
public ref class ConnectionOptions : public
 ManagementOptions
public class ConnectionOptions extends ManagementOptions
public class ConnectionOptions extends
 ManagementOptions
使用例使用例

リモート コンピュータに接続して、リモート コンピュータ上のオペレーティング システムに関する情報を表示する例を次に示します。既定の接続オプションを使用してリモート コンピュータに接続するために、ConnectionOptions が作成されます。

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
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"]);
        }
    }
}
継承階層継承階層
System.Object
   System.Management.ManagementOptions
    System.Management.ConnectionOptions
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

ConnectionOptions コンストラクタ ()

接続操作のための ConnectionOptions クラスの新しいインスタンスを、既定値を使用して初期化します。これは既定のコンストラクタです。

名前空間: System.Management
アセンブリ: System.Management (system.management.dll 内)
構文構文

Dim instance As New ConnectionOptions
public ConnectionOptions ()
public:
ConnectionOptions ()
public ConnectionOptions ()
public function ConnectionOptions ()
使用例使用例

リモート コンピュータに接続して、リモート コンピュータ上のオペレーティング システムに関する情報を表示する例を次に示します。既定の接続オプションを使用してリモート コンピュータに接続するために、ConnectionOptions が作成されます。

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
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"]);
        }
    }
}
.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

ConnectionOptions コンストラクタ (String, String, String, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan)

指定した値を使用して、WMI 接続に使用する ConnectionOptions クラスの新しいインスタンスを初期化します。

名前空間: System.Management
アセンブリ: System.Management (system.management.dll 内)
構文構文

Public Sub New ( _
    locale As String, _
    username As String, _
    password As String, _
    authority As String, _
    impersonation As ImpersonationLevel, _
    authentication As AuthenticationLevel, _
    enablePrivileges As Boolean, _
    context As ManagementNamedValueCollection, _
    timeout As TimeSpan _
)
Dim locale As String
Dim username As String
Dim password As String
Dim authority As String
Dim impersonation As ImpersonationLevel
Dim authentication As AuthenticationLevel
Dim enablePrivileges As Boolean
Dim context As ManagementNamedValueCollection
Dim timeout As TimeSpan

Dim instance As New ConnectionOptions(locale,
 username, password, authority, impersonation, authentication, enablePrivileges,
 context, timeout)
public ConnectionOptions (
    string locale,
    string username,
    string password,
    string authority,
    ImpersonationLevel impersonation,
    AuthenticationLevel authentication,
    bool enablePrivileges,
    ManagementNamedValueCollection context,
    TimeSpan timeout
)
public:
ConnectionOptions (
    String^ locale, 
    String^ username, 
    String^ password, 
    String^ authority, 
    ImpersonationLevel impersonation, 
    AuthenticationLevel authentication, 
    bool enablePrivileges, 
    ManagementNamedValueCollection^ context, 
    TimeSpan timeout
)
public ConnectionOptions (
    String locale, 
    String username, 
    String password, 
    String authority, 
    ImpersonationLevel impersonation, 
    AuthenticationLevel authentication, 
    boolean enablePrivileges, 
    ManagementNamedValueCollection context, 
    TimeSpan timeout
)
public function ConnectionOptions (
    locale : String, 
    username : String, 
    password : String, 
    authority : String, 
    impersonation : ImpersonationLevel, 
    authentication : AuthenticationLevel, 
    enablePrivileges : boolean, 
    context : ManagementNamedValueCollection, 
    timeout : TimeSpan
)

パラメータ

locale

接続に使用するロケール。

username

接続に使用するユーザー名。null の場合は、現在ログオンしているユーザーの資格情報を使用します。

password

指定されたユーザー名のパスワード。ユーザー名も null の場合は、現在ログオンしているユーザーの資格情報を使用します。

authority

指定したユーザーを認証するために使用する証明機関。

impersonation

接続に使用する COM 偽装レベル。

authentication

接続に使用する COM 認証レベル。

enablePrivileges

特別なユーザー特権を有効にするには true。それ以外の場合はfalse。このパラメータは、特別な Windows NT ユーザー特権を必要とする操作を実行する場合にだけ使用してください。

context

プロバイダに渡される、プロバイダ固有の名前付き値がペアとなったオブジェクト。

timeout

今後使用するために予約されています。

使用例使用例

リモート コンピュータに接続して、リモート コンピュータ上のオペレーティング システムに関する情報を表示する例を次に示します。目的の接続オプションを使用してリモート コンピュータに接続するために、ConnectionOptions が作成されます。

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.
        ' This example does not hard-code a password.  You need to pass
        ' in a password variable with the correct value or set it
        ' the value of the password property later.

       Dim options As ConnectionOptions
       options = New ConnectionOptions("MS_409",
 "userName", Nothing, _
            "ntdlmdomain:DOMAIN", _
            System.Management.ImpersonationLevel.Impersonate, _
            System.Management.AuthenticationLevel.Default, True,
 _
            Nothing, System.TimeSpan.MaxValue)

        ' 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
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 does not hard-code a password.  You need to
 pass
        // in a password variable with the correct value or set it
        // the value of the password property later.

        ConnectionOptions options = 
            new ConnectionOptions("MS_409", "userName",
 null, 
            "ntdlmdomain:DOMAIN", 
            System.Management.ImpersonationLevel.Impersonate,
            System.Management.AuthenticationLevel.Default, true
,
            null, System.TimeSpan.MaxValue);

        // 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"]);
        }
    }
}
.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

ConnectionOptions コンストラクタ


オーバーロードの一覧オーバーロードの一覧

名前 説明
ConnectionOptions () 接続操作のための ConnectionOptions クラスの新しいインスタンスを、既定値を使用して初期化します。これは既定のコンストラクタです。
ConnectionOptions (String, String, String, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan) 指定した値を使用して、WMI 接続に使用する ConnectionOptions クラスの新しいインスタンスを初期化します。
参照参照

関連項目

ConnectionOptions クラス
ConnectionOptions メンバ
System.Management 名前空間

ConnectionOptions プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ Authentication この接続の操作に使用する COM 認証レベルを取得または設定します。
パブリック プロパティ Authority 指定したユーザーを認証するために使用する証明機関を取得または設定します。
パブリック プロパティ Context  WMI (Windows Management Instrumentation) コンテキスト オブジェクトを取得または設定します。これは、カスタマイズされた操作のためのコンテキスト情報をサポートしている WMI プロバイダに渡す名前/値ペア リストです。 ( ManagementOptions から継承されます。)
パブリック プロパティ EnablePrivileges 接続操作のためにユーザー特権を有効にする必要があるかどうかを示す値を取得または設定します。このプロパティは、操作 (コンピュータの再起動など) を実行するために特定のユーザー特権を有効にする必要がある場合にだけ使用してください。
パブリック プロパティ Impersonation この接続の操作に使用する COM 偽装レベルを取得または設定します。
パブリック プロパティ Locale 接続操作に使用するロケールを取得または設定します。
パブリック プロパティ Password 指定したユーザーのパスワードを設定します。
パブリック プロパティ Timeout  操作に適用するタイムアウトを取得または設定します。コレクションを返す操作では、このタイムアウトはその操作自体ではなく、結果として得られるコレクションの列挙に適用されます。操作自体に適用するには、ReturnImmediately プロパティを使用します。このプロパティは、操作が半同期的に実行されることを示すために使用されます。 ( ManagementOptions から継承されます。)
パブリック プロパティ Username 接続操作に使用するユーザー名を取得または設定します。
参照参照

関連項目

ConnectionOptions クラス
System.Management 名前空間

ConnectionOptions メソッド


ConnectionOptions メンバ

WMI (Windows Management Instrumentation) 接続を確立するために必要なすべての設定を指定します。

ConnectionOptions データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド ConnectionOptions オーバーロードされます。  
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ Authentication この接続の操作に使用する COM 認証レベルを取得または設定します。
パブリック プロパティ Authority 指定したユーザーを認証するために使用する証明機関を取得または設定します。
パブリック プロパティ Context  WMI (Windows Management Instrumentation) コンテキスト オブジェクトを取得または設定します。これは、カスタマイズされた操作のためのコンテキスト情報をサポートしている WMI プロバイダに渡す名前/値ペア リストです。 (ManagementOptions から継承されます。)
パブリック プロパティ EnablePrivileges 接続操作のためにユーザー特権を有効にする必要があるかどうかを示す値を取得または設定します。このプロパティは、操作 (コンピュータの再起動など) を実行するために特定のユーザー特権を有効にする必要がある場合にだけ使用してください。
パブリック プロパティ Impersonation この接続の操作に使用する COM 偽装レベルを取得または設定します。
パブリック プロパティ Locale 接続操作に使用するロケールを取得または設定します。
パブリック プロパティ Password 指定したユーザーのパスワードを設定します。
パブリック プロパティ Timeout  操作に適用するタイムアウトを取得または設定します。コレクションを返す操作では、このタイムアウトはその操作自体ではなく、結果として得られるコレクションの列挙に適用されます。操作自体に適用するには、ReturnImmediately プロパティを使用します。このプロパティは、操作が半同期的に実行されることを示すために使用されます。 (ManagementOptions から継承されます。)
パブリック プロパティ Username 接続操作に使用するユーザー名を取得または設定します。
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

ConnectionOptions クラス
System.Management 名前空間



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「ConnectionOptions」の関連用語

ConnectionOptionsのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



ConnectionOptionsのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS