GetTsPolicies
Windows Management Instrumentation (WMI) クラス メソッドは、Configuration Managerで、指定したタスク シーケンスに関連付けられているすべてのポリシーを取得します。 ユーザーは、スタンドアロン以外のメディアを作成する権限を持っている必要があります。
次の構文は、マネージド オブジェクト形式 (MOF) コードから簡略化され、 メソッドを定義します。
構文
SInt32 GetTsPolicies(
String AdvertisementID,
String PackageID,
SMS_TaskSequence TaskSequence,
String AdvertisementName,
String AdvertisementComment,
UInt32 AdvertisementFlags,
String BootImageID,
String SourceSite,
String PolicyXmls[],
String PolicyAssignmentXmls[]
);
パラメーター
AdvertisementID
データ型: String
修飾子: [in]
ポリシーに埋め込むユーザー定義のアドバタイズ ID。 この ID は、サイトによって作成された他の広告 ID と競合しないようにしてください。
PackageID
データ型: String
修飾子: [in]
メソッドが、Configuration Manager データベースに格納されているタスク シーケンスのポリシーを取得する場合は、タスク シーケンス パッケージの ID。
PackageID
またはTaskSequence
は null 以外にできますが、両方のパラメーターを指定することはできません。
TaskSequence
データ型: SMS_TaskSequence
修飾子: [in]
タスク シーケンスを表すサーバー WMI クラス オブジェクトをSMS_TaskSequenceします。
PackageID
またはTaskSequence
は null 以外にできますが、両方のパラメーターを指定することはできません。
AdvertisementName
データ型: String
修飾子: [in]
提供情報のユーザー定義名。
AdvertisementComment
データ型: String
修飾子: [in]
提供情報のユーザー定義コメント。
AdvertisementFlags
データ型: UInt32
修飾子: [in]
提供情報の詳細を指定するユーザー定義フラグ。 これらのフラグの詳細については、「 SMS_Advertisement サーバー WMI クラス 」を参照してください。
BootImageID
データ型: String
修飾子: [in]
タスク シーケンスで使用するブート イメージ パッケージの ID。 このパラメーターは、 TaskSequence
パラメーターが定義されている場合に必要です。 それ以外の場合は、 null
に設定する必要があります。
SourceSite
データ型: String
修飾子: [in]
提供情報のソース サイトのコード。
PolicyXmls
データ型: 配列String
修飾子: [out]
指定したタスク シーケンスと依存ポリシーのポリシーを表す XML 文字列。
PolicyAssignmentXmls
データ型: 配列String
修飾子: [out]
PolicyXmls
によって指定されたポリシーの割り当てを表す XML 文字列。
PolicyXmls
PolicyAssignmentXmls
は、他方の n 番目の要素に対応する 1 つのパラメーターの n 番目の要素と共に配置されます。
戻り値
成功を示す 0、失敗を示す 0 以外のデータ型 SInt32
。
返されたエラーの処理については、「Configuration Manager エラーについて」を参照してください。
解説
タスク シーケンスのポリシーには、タスク シーケンス自体のポリシー、参照されているすべてのパッケージのポリシー、対応するポリシーの割り当てが含まれます。 タスク シーケンスは、データベースまたはメモリに WMI オブジェクトのセットとして格納できます。
タスク シーケンスがConfiguration Manager データベース内にある場合、アプリケーションでは、タスク シーケンス パッケージのパッケージ識別子を PackageID
パラメーターに指定する必要があります。 このパラメーターの値を指定する場合は、特定のタスク シーケンスの読み取りアクセス許可が必要です。
タスク シーケンスがメモリ内にある場合、アプリケーションでは、 TaskSequence
パラメーターと BootImageID
パラメーターの値を指定する必要があります。
要件
ランタイム要件
詳細については、「Configuration Manager サーバーランタイム要件」を参照してください。
開発要件
詳細については、「Configuration Manager サーバー開発要件」を参照してください。
関連項目
SMS_Advertisement サーバー WMI クラスSMS_TaskSequencePackageクラスの GetClientConfigPolicies メソッドSMS_TaskSequencePackageクラスのGetSequence メソッドSMS_TaskSequencePackageクラスのSetSequence メソッドSMS_TaskSequencePackage