GetTsPolicies Configuration Manager 中的 Windows Management Instrumentation (WMI) 類別方法會取得與指定工作順序相關聯的所有原則。 用戶必須擁有建立獨立媒體以外的許可權。
下列語法是從受控物件格式 (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]
要內嵌在原則中的使用者定義公告標識碼。 此標識元不應與網站所建立的其他廣告標識符衝突。
PackageID 資料類型: String
限定符:[in]
工作順序封裝的標識碼,如果方法是取得儲存在 Configuration Manager 資料庫中的工作順序原則。 或 PackageIDTaskSequence 可以是非 Null,但不能同時是兩個參數。
TaskSequence 資料類型: SMS_TaskSequence
限定符:[in]
SMS_TaskSequence代表工作順序的伺服器 WMI 類別物件。 或 PackageIDTaskSequence 可以是非 Null,但不能同時是兩個參數。
AdvertisementName 資料類型: String
限定符:[in]
廣告的使用者定義名稱。
AdvertisementComment 資料類型: String
限定符:[in]
廣告的用戶定義批注。
AdvertisementFlags 資料類型: UInt32
限定符:[in]
指定廣告詳細數據的使用者定義旗標。 如需這些旗標的詳細資訊 ,請參閱SMS_Advertisement伺服器 WMI 類別 。
BootImageID 資料類型: String
限定符:[in]
要與工作順序搭配使用的開機映像套件標識碼。 如果已定義 參數, TaskSequence 則需要此參數。 否則,它必須設定為 null。
SourceSite 資料類型: String
限定符:[in]
廣告來源網站的程序代碼。
PolicyXmls 數據類型: String 陣列
限定符:[out]
XML 字串,表示指定之工作順序和相依原則的原則。
PolicyAssignmentXmls 數據類型: String 陣列
限定符:[out]
XML 字串,表示 所指定原則的 PolicyXmls指派。
PolicyXmls 和 PolicyAssignmentXmls 會對齊,其中一個參數的第 n 個元素對應至另一個參數的第 n 個專案。
傳回值
數據 SInt32 類型,為 0 表示成功或非零表示失敗。
如需處理傳回錯誤的相關信息,請參閱關於 Configuration Manager 錯誤。
註解
工作順序的原則包括工作順序本身的原則、所有參考套件的原則,以及對應的原則指派。 工作順序可以儲存在資料庫或記憶體中做為一組 WMI 物件。
如果工作順序位於 Configuration Manager 資料庫中,您的應用程式應該在 參數中指定工作順序封裝的PackageID封裝標識符。 如果提供此參數的值,您必須具有特定工作順序的讀取許可權。
如果工作順序位於記憶體中,您的應用程式必須指定 TaskSequence 和 BootImageID 參數的值。
需求
運行時間需求
如需詳細資訊,請參閱 Configuration Manager 伺服器運行時間需求。
開發需求
如需詳細資訊,請參閱 Configuration Manager 伺服器開發需求。
另請參閱
SMS_Advertisement類別中類別 SMS_TaskSequencePackageSetSequence 方法中類別SMS_TaskSequencePackage GetSequence 方法的伺服器 WMI 類別 getClientConfigPolicies 方法SMS_TaskSequencePackage類別SMS_TaskSequencePackage