ConnectionOptions.Authentication プロパティ

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

ConnectionOptions.Authentication プロパティ

この接続の操作に使用する COM 認証レベルを取得または設定します。

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

Visual Basic (宣言)

Public Property Authentication As
 AuthenticationLevel

Visual Basic (使用法)

Dim instance As ConnectionOptions
Dim value As AuthenticationLevel

value = instance.Authentication

instance.Authentication = value

C#

public AuthenticationLevel Authentication { get;
 set; }

C++

public:
property AuthenticationLevel Authentication {
    AuthenticationLevel get ();
    void set (AuthenticationLevel value);
}

J#

/** @property */
public AuthenticationLevel get_Authentication ()

/** @property */
public void set_Authentication (AuthenticationLevel
 value)

JScript

public function get Authentication
 () : AuthenticationLevel

public function set Authentication
 (value : AuthenticationLevel)

プロパティ値
ローカルまたはリモート コンピュータへの接続に使用される COM 認証レベルを示す AuthenticationLevel 列挙値を返します。

解説

Windows 2000 以前では、WMI サービスで接続レベルの認証が要求されます。Windows XP 以降では、パケット レベルの認証が要求されます。クライアントで特別な認証設定が必要な場合は、このプロパティを使用して、この特定の接続の認証レベルを管理できます。たとえば、クライアント側ですべての通信を暗号化する必要がある場合は、このプロパティに AuthenticationLevel.PacketPrivacy を設定します。

プロパティ値

この接続の操作に使用する COM 認証レベル。既定値は AuthenticationLevel.Unchanged です。この値は、標準 DCOM ネゴシエーション プロセスに応じて、サーバーから要求される認証レベルをクライアントが使用することを示します。

.NET Framework のセキュリティ

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

使用例

リモート コンピュータに接続して、リモート コンピュータ上のオペレーティング システムに関する情報を表示する例を次に示します。目的の接続オプションを使用してリモート コンピュータに接続するために、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
        options.Authentication = 6
        ' System.Management.AuthenticationLevel.PacketPrivacy = 6

        ' 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();
        options.Authentication = 
            System.Management.AuthenticationLevel.PacketPrivacy;
                 
        // 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 名前空間
AuthenticationLevel 列挙体