マネージド コードを使用してConfiguration Manager オブジェクトを読み取る方法
マネージド SMS プロバイダーを使用してConfiguration Manager オブジェクト インスタンスを読み取るには、WqlConnectionManager.GetInstance を使用します。 GetInstance メソッドは、特定のオブジェクト インスタンスを識別し、オブジェクトへのアクセスに使用される IResultObject オブジェクトを返す文字列を受け取ります。
次の関数例は、指定されたパッケージ識別子の名前と説明を示しています。
Configuration Manager オブジェクトを読み取る
SMS プロバイダーへの接続を設定します。 詳細については、「マネージド コードを使用してConfiguration Managerで SMS プロバイダーに接続する方法」を参照してください。
WqlConnectionManager クラス GetInstance メソッドを呼び出して、目的のオブジェクトの IResultObject オブジェクトを取得します。
IResultObject のプロパティを表示します。
例
次のコード例は、Configuration Manager オブジェクトを読み取る方法を示しています。
サンプル コードの呼び出しについては、「Configuration Manager コード スニペットの呼び出し」を参照してください。
public void DisplayPackageName(WqlConnectionManager connection, string packageID)
{
try
{
// Get the package.
IResultObject package = connection.GetInstance(@"SMS_Package.PackageID='" + packageID + "'");
Console.WriteLine("Package Name: " + package["Name"].StringValue);
Console.WriteLine("Package Description: " + package["Description"].StringValue);
}
catch (SmsException ex)
{
Console.WriteLine("Failed to get package. Error: " + ex.Message);
throw;
}
}
この例のメソッドには、次のパラメーターがあります。
パラメーター | 型 | 説明 |
---|---|---|
Connection |
-管理: WqlConnectionManager |
- SMS プロバイダーへの有効な接続。 |
PackageID |
-管理: String |
有効なパッケージ識別子。 SMS_Package クラス PackageID プロパティから取得します。 |
コードのコンパイル
名前空間
System
System.Collections.Generic
System.ComponentModel
Microsoft。ConfigurationManagement.ManagementProvider
Microsoft。ConfigurationManagement.ManagementProvider.WqlQueryEngine
Assembly
microsoft.configurationmanagement.managementprovider
adminui.wqlqueryengine
堅牢なプログラミング
発生できるConfiguration Manager例外は、SmsConnectionException と SmsQueryException です。 これらは SmsException と一緒にキャッチできます。
関連項目
オブジェクトの概要Configuration Manager遅延プロパティ
マネージド コードを使用してConfiguration Manager オブジェクト クラス メソッドを呼び出す方法
マネージド コードを使用してConfiguration Manager プロバイダーに接続する方法
マネージド コードを使用してConfiguration Manager オブジェクトを作成する方法
マネージド コードを使用してConfiguration Manager オブジェクトを変更する方法
マネージド コードを使用して非同期Configuration Manager クエリを実行する方法
マネージド コードを使用して同期Configuration Manager クエリを実行する方法
マネージド コードを使用して遅延プロパティを読み取る方法