ConnectionOptions コンストラクタ ()

.NET Framework クラス ライブラリ リファレンス

ConnectionOptions コンストラクタ ()

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New ConnectionOptions

C#

public ConnectionOptions ()

C++

public:
ConnectionOptions ()

J#

public ConnectionOptions ()

JScript

public function ConnectionOptions ()

使用例

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

Visual Basic

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

C#

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 のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ConnectionOptions クラス
ConnectionOptions メンバ
System.Management 名前空間

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

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)

C#

public ConnectionOptions (
    string locale,
    string username,
    string password,
    string authority,
    ImpersonationLevel impersonation,
    AuthenticationLevel authentication,
    bool enablePrivileges,
    ManagementNamedValueCollection context,
    TimeSpan timeout
)

C++

public:
ConnectionOptions (
    String^ locale, 
    String^ username, 
    String^ password, 
    String^ authority, 
    ImpersonationLevel impersonation, 
    AuthenticationLevel authentication, 
    bool enablePrivileges, 
    ManagementNamedValueCollection^ context, 
    TimeSpan timeout
)

J#

public ConnectionOptions (
    String locale, 
    String username, 
    String password, 
    String authority, 
    ImpersonationLevel impersonation, 
    AuthenticationLevel authentication, 
    boolean enablePrivileges, 
    ManagementNamedValueCollection context, 
    TimeSpan timeout
)

JScript

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 が作成されます。

Visual Basic

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

C#

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 のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ConnectionOptions クラス
ConnectionOptions メンバ
System.Management 名前空間

ConnectionOptions コンストラクタ

オーバーロードの一覧

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

参照

関連項目

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