Reporting Services の WMI プロバイダ

Reporting Services に備わっている Windows Management Instrumentation (WMI) クラスを使用すれば、ローカル コンピュータおよびリモート コンピュータ上のレポート サーバーとレポート マネージャ コンポーネントを管理し、ネットワーク内で、レポート サーバー Web サービスを実行しているコンピュータを検出する方法を提供できます。また、レポート サーバー インスタンスをアクティブ化して、スケールアウト配置に追加することも可能です。システム管理者およびデータベース管理者は、このクラスを使用して、インストールの完了後にレポート サーバーとレポート マネージャの構成を変更したり、ローカル サーバーまたはリモート サーバーの管理タスクを実行したりできます。タスクには、レポート サーバーとレポート サーバー データベース間のデータベース接続の資格情報の変更、レポート サーバー データベースの名前変更、レポート サーバー インスタンスまたはレポート マネージャへのインストール パスを定義する URL の変更があります。

これらの機能をサポートするためにインストールされるクラスは、次のとおりです。

  • MSReportServer_ConfigurationSetting クラスは、レポート サーバー インスタンスのインストール パラメータとランタイム パラメータを表します。これらのパラメータは、レポート サーバーの RSReportServer.config 構成ファイルに保存されます。
  • MSReportServer_ConfigurationSettingForSharePoint クラス は、SharePoint 統合モード用に構成されたレポート サーバー インスタンスのインストール パラメータとランタイム パラメータを表します。これらのパラメータは、レポート サーバーの RSReportServer.config 構成ファイルに保存されます。
  • MSReportManager_ConfigurationSetting クラスは、レポート マネージャ インスタンスのインストール パラメータとランタイム パラメータを表します。これらのパラメータは、レポート マネージャの RSWebApplication.config 構成ファイルに保存されます。

このトピックに示すコード サンプルで Reporting Services の情報を取得するために使用する名前空間は、System.Management 名前空間です。この名前空間は Microsoft .NET Framework にあります。System.Management 名前空間により、管理情報にアクセスしてその情報を操作するときに .NET Framework アプリケーションで使用するマネージ コード クラスのセットが提供されます。System.Management 名前空間による Reporting Services の WMI クラスの使用の詳細については、Microsoft .NET Framework SDK の「System.Management による管理情報へのアクセス」を参照してください。

レポート サーバー インスタンスの検索

コンピュータにレポート サーバーの複数のインスタンスがインストールされている場合、管理者はコンピュータでプロパティが変更されている正確なインスタンスをポイントする必要があります。そのインスタンスを直接検索するために、キーとして定義されるプロパティが各クラスに含まれています。このキー プロパティにより、レポート サーバーのインストールが一意に識別されます。キーとして定義されるプロパティは、PathName プロパティです。このプロパティの値は、構成ファイルの名前を含む RSReportServer.config 構成ファイルへのパスです。ほとんどのインストールでは、このパスは次の例のようになります。

C:\Program Files\Microsoft SQL Server\MSSQL\Reporting Services\ReportServer\rsreportserver.config

MSReportServer_ConfigurationSetting クラスが作成されると、キーを入力してそのキーと一致するレポート サーバーまたはレポート マネージャのインスタンスをコンピュータで検索できます。見つかった場合、そのインスタンスの残りの値を使用して管理コレクションを作成します。

また、コレクションを作成し、管理クラスによってループして情報を表示することによって、情報を入手することもできます。このコードを Visual Studio から実行する場合は、プロジェクト参照を System.Management に追加します。次の例は、RSReportServer.config 構成ファイルが C:\Program Files\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer\bin にあることを前提とします。System.Management クラスのメソッドの説明は、Microsoft .NET Framework SDK にあります。

レポート サーバーのインストールの情報を検索するさらに適切な方法は、WMI インスタンスのコレクションを使用して列挙することです。以下の例は、コレクションを作成し、コレクションによってループしてプロパティを表示することによって、レポート サーバー インスタンスごとにプロパティを検索する方法を示します。

Imports System
Imports System.Management
Imports System.IO

Module Module1
    Sub Main()
        Const WmiNamespace As String = "\\localhost\root\Microsoft\SqlServer\ReportServer\v9\Admin"
        Const WmiRSClass As String = _
           "\\localhost\root\Microsoft\SqlServer\ReportServer\v9\admin:MSReportServer_ConfigurationSetting"

        Dim serverClass As ManagementClass
        Dim scope As ManagementScope
        scope = New ManagementScope(WmiNamespace)
        'Connect to the Reporting Services namespace.
        scope.Connect()

        'Create the server class.
        serverClass = New ManagementClass(WmiRSClass)
        'Connect to the management object.
        serverClass.Get()
        If serverClass Is Nothing Then Throw New Exception("No class found")

        'Loop through the instances of the server class.
        Dim instances As ManagementObjectCollection = serverClass.GetInstances()
        Dim instance As ManagementObject
        For Each instance In instances
            Console.Out.WriteLine("Instance Detected")
            Dim instProps As PropertyDataCollection = instance.Properties
            Dim prop As PropertyData
            For Each prop In instProps
                Dim name As String = prop.Name
                Dim val As Object = prop.Value
                Console.Out.Write("Property Name: " + name)
                If val Is Nothing Then
                    Console.Out.WriteLine("     Value: <null>")
                Else
                    Console.Out.WriteLine("     Value: " + val.ToString())
                End If
            Next
        Next

        Console.WriteLine("--- Press any key ---")
        Console.ReadKey()


    End Sub
End Module
using System;
using System.Management;
using System.IO;
[assembly: CLSCompliant(true)]

class Class1
{
    [STAThread]
    static void Main(string[] args)
    {
        const string WmiNamespace = @"\\localhost\root\Microsoft\SqlServer\ReportServer\v9\Admin";
        const string WmiRSClass =
          @"\\localhost\root\Microsoft\SqlServer\ReportServer\v9\admin:MSReportServer_ConfigurationSetting";
        ManagementClass serverClass;
        ManagementScope scope;
        scope = new ManagementScope(WmiNamespace);

        // Connect to the Reporting Services namespace.
        scope.Connect();
        // Create the server class.
        serverClass = new ManagementClass(WmiRSClass);
        // Connect to the management object.
        serverClass.Get();
        if (serverClass == null)
            throw new Exception("No class found");

        // Loop through the instances of the server class.
        ManagementObjectCollection instances = serverClass.GetInstances();

        foreach (ManagementObject instance in instances)
        {
            Console.Out.WriteLine("Instance Detected");
            PropertyDataCollection instProps = instance.Properties;
            foreach (PropertyData prop in instProps)
            {
                string name = prop.Name;
                object val = prop.Value;
                Console.Out.Write("Property Name: " + name);
                if (val != null)
                    Console.Out.WriteLine("     Value: " + val.ToString());
                else
                    Console.Out.WriteLine("     Value: <null>");
            }
        }
        Console.WriteLine("\n--- Press any key ---");
        Console.ReadKey();
    }
}

レポート サーバーとレポート マネージャで読み取りおよび変更可能なプロパティの詳細については、「Reporting Services WMI プロバイダ ライブラリ」を参照してください。レポート サーバー固有のプロパティの詳細については、「MSReportServer_ConfigurationSetting クラス」を参照してください。レポート マネージャ固有のプロパティの詳細については、「MSReportManager_ConfigurationSetting クラス」を参照してください。構成ファイルの既定のインストールについては、「Reporting Services の構成ファイル」を参照してください。

変更履歴

リリース 履歴

2006 年 12 月 12 日

新しい内容 :
  • MSReportServer_ConfigurationSettingForSharePoint クラス

参照

その他の技術情報

Reporting Services のプログラミング

ヘルプおよび情報

SQL Server 2005 の参考資料の入手