SMS_Advertisement Configuration Manager,Windows Management Instrumentation (WMI) 類別是 SMS 提供者伺服器類別,代表用來宣告可在用戶端上執行的軟體套件程式公告。
下列語法是從 MOF) 程式碼 (Managed Object Format 簡化而來,並包含所有繼承的屬性。
語法
Class SMS_Advertisement : SMS_BaseClass
{
UInt32 ActionInProgress;
UInt32 AdvertFlags;
String AdvertisementID;
String AdvertisementName;
SMS_ScheduleToken AssignedSchedule[];
Boolean AssignedScheduleEnabled;
Boolean AssignedScheduleIsGMT;
UInt32 AssignmentID;
String CollectionID;
String Comment;
UInt32 DeviceFlags;
DateTime ExpirationTime;
Boolean ExpirationTimeEnabled;
Boolean ExpirationTimeIsGMT;
String HierarchyPath;
Boolean IncludeSubCollection;
UInt8 ISVData[];
UInt32 ISVDataSize;
String ISVString;
UInt32 MandatoryCountdown;
UInt32 OfferType;
String PackageID;
DateTime PresentTime;
Boolean PresentTimeEnabled;
Boolean PresentTimeIsGMT;
UInt32 Priority;
String ProgramName;
UInt32 RemoteClientFlags;
String SourceSite;
UInt32 TimeFlags;
};
方法
下表列出類別中 SMS_Advertisement 的方法。
| 方法 | 描述 |
|---|---|
| 類別 SMS_Advertisement 中的 GetAdvertisements 方法 | 取得以資源為目標的廣告識別碼。 |
| 類別 SMS_Advertisement 中的 GetNextID 方法 | 擷取下一個建立的廣告所要使用的識別碼。 |
| 課程 SMS_Advertisement 中的 RiskyDeploymentStatusMessage 方法 | 傳送有關使用者部署至風險集合的警告狀態訊息。 |
| 類別 SMS_Advertisement 中的 SetNextID 方法 | 設定下一個建立的廣告所要使用的識別碼。 |
| 類別 SMS_Advertisement 中的 SetSourceSite 方法 | 設定廣告的原始網站程式碼。 |
| 課程 SMS_Advertisement 中的解鎖方法 | 將來源網站設定為目前網站,解除鎖定廣告。 警告: 此方法已被取代。 |
屬性
ActionInProgress
資料類型:UInt32
存取類型:唯讀
限定詞:[read, enumeration]
Configuration Manager 正在對套件執行的目前動作。 可能的值為:
| 值 | 描述 |
|---|---|
| 0 | NONE |
| 1 | UPDATE |
| 2 | 新增 |
AdvertFlags
資料類型:UInt32
存取類型:讀取/寫入
限定詞:[位元]
旗標,指出應如何向使用者宣告廣告。 下面列出可能的值。 預設值為 0。
| 十六進位 (位元) | 描述 |
|---|---|
| 0x00000020 (5) | 立即。 立即向使用者宣布廣告。 |
| 0x00000100 (8) | ONSYSTEMSTARTUP。 在系統啟動時向使用者宣告公告。 |
| 0x00000200 (9) | ONUSERLOGON。 在登入時向使用者宣告公告。 |
| 0x00000400 (10) | ONUSERLOGOFF。 在登出時向使用者宣告公告。 |
| 0x00001000 (12) | OPTIONALPREDOWNLOAD。 如果選取的架構和語言與用戶端的架構和語言相符,則會提前下載套件內容 |
| 0x00008000 (15) | WINDOWS_CE。 廣告適用於裝置用戶端。 |
| 0x00010000 (16) | ENABLE_PEER_CACHING。 本資訊適用於 System Center 2012 Configuration Manager SP1 或更新版本,以及 System Center 2012 R2 Configuration Manager 或更新版本。 |
| 0x00020000 (17) | DONOT_FALLBACK。 請勿回復到未受保護的發佈點。 |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE。 工作順序可供抽取式媒體和預引導執行環境 (PXE) 服務點使用。 |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS。 覆寫維護時段,將公告告知使用者。 |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS。 在維護視窗外重新啟動。 |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED。 向啟用網路喚醒的使用者宣告廣告。 |
| 0x00800000 (23) | SHOW_PROGRESS。 向使用者宣告顯示工作順序進度的廣告。 |
| 0x02000000 (25) | NO_DISPLAY。 使用者不應獨立於指派之外執行程式。 |
| 0x04000000 (26) | ONSLOWNET。 在較慢的網路連線情況下必須進行作業。 |
| 0x10000000 (28) | TARGETTOWINPE. 僅將此部署設定為 WinPE 目標。 |
| 0x20000000 (29) | HIDDENINWINPE. 僅將此部署設定為 WinPE 的目標,但隱藏在 WinPE 中。 它只能由 TS 變數 SMSTSPreferredAdvertID 使用。 |
這些旗標必須與公告程式屬性中 ProgramFlags 指定的旗標協調。 例如,如果您設定 ONUSERLOGOFF,則必須在程式中設定 NOUSERLOGGEDIN 旗標。 如果標幟設定不相符,則不會公告該計畫。 如需詳細資訊,請參閱 SMS_Program Server WMI 類別。
設定 IMMEDIATE、ONUSERLOGON 或 ONUSERLOGOFF 或 AssignedSchedule 提供值,會使公告的程式必須執行。 強制程式會在用戶端收到廣告之後自動執行。 用戶端無法拒絕或延後安裝。
只有在已設定 IMMEDIATE、ONUSERLOGON 或 ONUSERLOGOFF 位元或程式有值 AssignedSchedule 時,才設定 NO_DISPLAY 和 ONSLOWNET 位元。
當您不希望使用者獨立於指派之外執行程式時,請設定NO_DISPLAY。 如果未設定此旗標,則公告會顯示在公告清單中,而且可以獨立於指派而執行。 該計劃仍可是強制性。
當透過慢速網路連線必須進行指派時,例如電腦使用數據機連線時,請設定 ONSLOWNET。
AdvertisementID
資料類型:String
存取類型:讀取/寫入
限定詞:[key, ResID (801) , ResDLL (“SMS_RSTT.dll”) ]
唯一自動產生的金鑰,用於識別廣告。 預設值為 “”。
AdvertisementName
資料類型:String
存取類型:讀取/寫入
限定詞:[Not_null]
廣告的唯一易記名稱。
AssignedSchedule 資料類型: SMS_ScheduleToken 陣列
存取類型:讀取/寫入
限定詞:[最大 (15) ,延遲]
SMS_ScheduleToken伺服器 WMI 類別 物件,指出當廣告在用戶端上變成強制時間。
AssignedScheduleEnabled
資料類型:Boolean
存取類型:讀取/寫入
限定詞:[lazy]
true 屬性中 AssignedSchedule 定義的排程是否為使用中。 預設值為 false。
AssignedScheduleIsGMT
資料類型:Boolean
存取類型:讀取/寫入
限定詞:[lazy]
true 如果屬性中 AssignedSchedule 定義的排程是採用通用公制時間 (UMT) 。 預設值為 false。
AssignmentID
資料類型:UInt32
存取類型:唯讀
限定詞:[閱讀]
與廣告相關聯的作業識別碼。
CollectionID
資料類型:String
存取類型:讀取/寫入
限定詞:[Not_null]
廣告目標的現有集合。
Comment
資料類型:String
存取類型:讀取/寫入
限定詞:無
關於廣告的簡單描述或附註。 預設值為 “”。
DeviceFlags
資料類型:UInt32
存取類型:讀取/寫入
限定詞:無
旗標描述裝置。 下面列出可能的值。 預設值為 0。
| 十六進位 (位元) | 描述 |
|---|---|
| 0x01000000 (24) | 一律將程式指派給用戶端。 |
| 0x02000000 (25) | 只有在裝置目前連線到高頻寬連線時才指派, (預設值高於 60 KBps) 。 |
| 0x04000000 (26) | 只有在裝置已停駐,亦即已連結至使用 ActiveSync 的桌面時,才進行指派。 |
ExpirationTime
資料類型:DateTime
存取類型:讀取/寫入
限定詞:無
廣告不再可供客戶使用的日期和時間。 預設值為 19900101000000.000000+****。
ExpirationTimeEnabled
資料類型:Boolean
存取類型:讀取/寫入
限定詞:[lazy]
true 如果廣告在屬性指定的 ExpirationTime 時間到期。 預設值為 false。
ExpirationTimeIsGMT
資料類型:Boolean
存取類型:讀取/寫入
限定詞:[lazy]
true 屬性中 ExpirationTime 定義的時間是否以 UMT 表示。 預設值為 false。
HierarchyPath
資料類型:String
存取類型:讀取/寫入
限定詞:無
保留。
IncludeSubCollection
資料類型:Boolean
存取類型:讀取/寫入
限定詞:無
true (預設) 是否將廣告通告至指定集合的子集合。
ISVData
資料類型: Uint8 陣列
存取類型:讀取/寫入
限定詞:[大、懶人]
允許單一 ISV 儲存與執行個體相關 SMS_Program 資料的資訊。 此資料沒有任何限制或定義的格式。 不過,請務必在建立 ISV 擁有權之後覆寫屬性。 因此,呼叫應用程式應該先讀取此屬性中的現有資料。 如果資料不屬於應用程式,則不應修改。 使用此屬性的任何 ISV 或應用程式擁有者都應該在資料中包含識別碼,以便輕鬆建立擁有權。
ISVDataSize
資料類型:UInt32
存取類型:讀取/寫入
限定詞:[lazy]
屬性所 ISVData 代表的資料大小。 預設值為 0。
ISVString
資料類型:String
存取類型:讀取/寫入
限定詞:無
合作夥伴擴充性的字串。
MandatoryCountdown
資料類型:UInt32
存取類型:讀取/寫入
限定詞:無
顯示作業系統部署使用者通知強制排程倒數計時的持續時間,以分鐘為單位。 預設值為 0。
OfferType
資料類型:UInt32
存取類型:讀取/寫入
限定詞:[enumeration]
表示廣告以使用者為目標的廣告類型。
| 值 | 描述 |
|---|---|
| 0 | 必要 |
| 2 | 可以使用 |
PackageID
資料類型:String
存取類型:讀取/寫入
限定詞:[Not_null]
與廣告相關聯之現有套件的 ID。 該值必須大寫。
PresentTime
資料類型:DateTime
存取類型:讀取/寫入
限定詞:無
向客戶提供廣告的日期和時間。 預設值為 19900101000000.000000+****。
PresentTimeEnabled
資料類型:Boolean
存取類型:讀取/寫入
限定詞:[lazy]
true如果Configuration Manager強制使用目前時間,則 (預設) 。
PresentTimeIsGMT
資料類型:Boolean
存取類型:讀取/寫入
限定詞:[lazy]
true 屬性中 PresentTime 定義的時間是否以 UMT 表示。 預設值為 false。
Priority
資料類型:UInt32
存取類型:讀取/寫入
限定詞:[enumeration]
用來將公告複寫至子網站的優先順序。 下面列出可能的值。 預設值為 NORMAL (2) 。
| 值 | 描述 |
|---|---|
| 1 | HIGH |
| 2 | 一般 |
| 3 | LOW |
ProgramName
資料類型:String
存取類型:讀取/寫入
限定詞:[Not_null]
指定套件內的程式 () PackageID 通告。
RemoteClientFlags
資料類型:UInt32
存取類型:讀取/寫入
限定詞:[位元]
旗標,指定當用戶端在本機或遠端連線到發佈點時程式應如何執行。 下面列出可能的值。 預設值為 48。
| 十六進位 (位元) | 描述 |
|---|---|
| 0x00000001 (0) | BATTERY_POWER。 使用電池電力執行程式。 此值目前未使用。 |
| 0x00000002 (1) | RUN_FROM_CD。 從 CD 執行程式。 此值目前未使用。 |
| 0x00000004 (2) | DOWNLOAD_FROM_CD。 從光碟下載程式。 此值目前未使用。 |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT。 從本機發佈點執行程式。 |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT。 從本機發佈點下載程式。 |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT。 如果沒有本機發佈點,請勿執行該程式。 |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT。 從遠端發佈點下載程式。 |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT。 從遠端發佈點執行程式。 |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP。 從本機發佈點視需要下載程式。 這僅適用於工作順序。 |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP。 從遠端發佈點按需下載程式。 這僅適用於工作順序。 |
| x00000400 (10) | BALLOON_REMINDERS_REQUIRED。 氣球提醒是必需的。 |
| 0x00000800 (11) | RERUN_ALWAYS。 請務必重新執行程式。 |
| 0x00001000 (12) | RERUN_NEVER。 永不重新執行程式。 |
| 0x00002000 (13) | RERUN_IF_FAILED。 如果先前執行失敗,請重新執行程式。 |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED。 如果先前已成功執行,請重新執行程式。 |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES 本資訊適用於 System Center 2012 Configuration Manager SP1 或更新版本,以及 System Center 2012 R2 Configuration Manager 或更新版本。 |
| 0x00020000 (17) | 不要T_FALLBACK 本資訊適用於 System Center 2012 Configuration Manager SP1 或更新版本,以及 System Center 2012 R2 Configuration Manager 或更新版本。 |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK 本資訊適用於 System Center 2012 Configuration Manager SP1 或更新版本,以及 System Center 2012 R2 Configuration Manager 或更新版本。 |
SourceSite
資料類型:String
存取類型:唯讀
限定詞:[閱讀]
廣告原始網站的三個字母網站代碼。
TimeFlags
資料類型:UInt32
存取類型:唯讀
限定詞:[讀取,位元]
保留給內部使用。 在時間相關屬性中重複資訊的旗標。 下面列出可能的值。 例如,ENABLE_PRESENT 會在 等true於 PresentTimeEnabled 時設定。
| 十六進位 (位元) | 描述 |
|---|---|
| 0x00000001 (0) | ENABLE_PRESENT |
| 0x00000002 (1) | ENABLE_EXPIRATION |
| 0x00000004 (2) | ENABLE_AVAILABLE |
| 0x00000008 (3) | ENABLE_UNAVAILABLE |
| 0x00000010 (4) | ENABLE_MANDATORY |
| 0x00000020 (5) | GMT_PRESENT |
| 0x00000040 (6) | GMT_EXPIRATION |
| 0x00000080 (7) | GMT_AVAILABLE |
| 0x00000100 (8) | GMT_UNAVAILABLE |
| 0x00000200 (9) | GMT_MANDATORY |
註解
此類別的類別限定詞包括:
安全的
如需 [屬性] 區段中包含的類別限定詞和屬性限定詞的詳細資訊,請參閱 Configuration Manager 類別和屬性限定詞。
雖然沒有其他索引鍵屬性,但屬性
AdvertisementName、CollectionID及PackageID都ProgramName限定為NOT_NULL,且必須提供值。 建立類別實例之後,您的應用程式無法更新這些屬性。 若要變更這些值,應用程式必須刪除執行個體,並建立具有正確值的新執行個體。
需求
執行階段需求
如需詳細資訊,請參閱 Configuration Manager 伺服器執行階段需求。
開發需求
如需詳細資訊,請參閱 Configuration Manager 伺服器開發需求。