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

2007-08-14

指定した値を使用して、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 のセキュリティ

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

プラットフォーム

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