SMS_Advertisement 伺服器 WMI 類別

Windows SMS_Advertisement Management Instrumentation (WMI) 類別是 Configuration Manager 中的 SMS 提供者伺服器類別，代表用來宣告可在用戶端上執行之軟體套件程式的公告。

下列語法已從受控物件格式 (MOF) 程式代碼簡化，並包含所有繼承的屬性。

語法

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中的 Unlock 方法	將來源網站設定為目前的網站，以解除鎖定公告。警告：這個方法已被取代。

屬性

`ActionInProgress`

資料類型：UInt32

存取類型：只讀

限定符：[讀取、列舉]

Configuration Manager 在套件上執行的目前動作。可能的值為：

值	描述
0	沒有
1	UPDATE
2	加

`AdvertFlags`

資料類型：UInt32

存取類型：讀取/寫入

限定符：[bits]

旗標，指出應如何向使用者公告廣告。可能的值如下所示。預設值為 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伺服器 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

存取類型：讀取/寫入

限定符：[延遲]

true 如果屬性中定義的排程為作用中， AssignedSchedule 則為。預設值為 false。

`AssignedScheduleIsGMT`

資料類型：Boolean

存取類型：讀取/寫入

限定符：[延遲]

true 如果屬性中定義的 AssignedSchedule 排程在通用計量時間 (UMT) 。預設值為 false。

`AssignmentID`

資料類型：UInt32

存取類型：只讀

限定符：[read]

與公告相關聯之指派的標識碼。

`CollectionID`

資料類型：String

存取類型：讀取/寫入

限定符：[Not_null]

廣告的目標現有集合。

`Comment`

資料類型：String

存取類型：讀取/寫入

限定符：無

關於廣告的簡單描述或注意事項。預設值為 “ ”

`DeviceFlags`

資料類型：UInt32

存取類型：讀取/寫入

限定符：無

描述裝置的旗標。可能的值如下所示。預設值為 0。

十六進位 (位)	描述
0x01000000 (24)	一律將程式指派給用戶端。
0x02000000 (25)	只有在裝置目前連線到高頻寬連線 (默認高於 60 KBps) 時才指派。
0x04000000 (26)	只有當裝置停駐時才指派，也就是它已連結至使用 ActiveSync 的桌面。

`ExpirationTime`

資料類型：DateTime

存取類型：讀取/寫入

限定符：無

用戶端無法再使用公告的日期和時間。默認值為 19900101000000.000000+*}。

`ExpirationTimeEnabled`

資料類型：Boolean

存取類型：讀取/寫入

限定符：[延遲]

true 如果公告在屬性所指出的時間過期，則為 ExpirationTime 。預設值為 false。

`ExpirationTimeIsGMT`

資料類型：Boolean

存取類型：讀取/寫入

限定符：[延遲]

true 如果屬性中 ExpirationTime 定義的時間是在 UMT 中，則為。預設值為 false。

`HierarchyPath`

資料類型：String

存取類型：讀取/寫入

限定符：無

保留。

`IncludeSubCollection`

資料類型：Boolean

存取類型：讀取/寫入

限定符：無

true (預設) 廣告是否通告至指定集合的子集合。

`ISVData`

數據類型： Uint8 陣列

存取類型：讀取/寫入

限定符：[大型、延遲]

可讓單一 ISV 儲存與實例相關 SMS_Program 數據的資訊。此數據沒有任何限制或已定義的格式。不過，在建立其ISV擁有權之後，請務必不要覆寫屬性。因此，呼叫的應用程式應該先讀取這個屬性中的現有數據。如果數據不屬於應用程式，則不應加以修改。任何使用此屬性的ISV或應用程式擁有者都應該在數據中包含標識碼，以便輕鬆建立擁有權。

`ISVDataSize`

資料類型：UInt32

存取類型：讀取/寫入

限定符：[延遲]

屬性所 ISVData 表示的數據大小。預設值為 0。

`ISVString`

資料類型：String

存取類型：讀取/寫入

限定符：無

夥伴擴充性的字串。

`MandatoryCountdown`

資料類型：UInt32

存取類型：讀取/寫入

限定符：無

顯示作系統部署使用者通知強制排程倒數計時的持續時間，以分鐘為單位。預設值為 0。

`OfferType`

資料類型：UInt32

存取類型：讀取/寫入

限定符：[列舉]

指出廣告是以用戶為目標的廣告類型。

值	描述
0	必要
2	可以使用

`PackageID`

資料類型：String

存取類型：讀取/寫入

限定符：[Not_null]

與公告相關聯之現有套件的標識符。值必須是大寫。

`PresentTime`

資料類型：DateTime

存取類型：讀取/寫入

限定符：無

公告提供給用戶端的日期和時間。默認值為 19900101000000.000000+*}。

`PresentTimeEnabled`

資料類型：Boolean

存取類型：讀取/寫入

限定符：[延遲]

true如果目前時間是由 Configuration Manager 強制執行， (預設) 。

`PresentTimeIsGMT`

資料類型：Boolean

存取類型：讀取/寫入

限定符：[延遲]

true 如果屬性中 PresentTime 定義的時間是在 UMT 中，則為。預設值為 false。

`Priority`

資料類型：UInt32

存取類型：讀取/寫入

限定符：[列舉]

將廣告復寫至子網站時所使用的優先順序。可能的值如下所示。預設值為 NORMAL (2) 。

值	描述
1	高
2	正常
3	低

`ProgramName`

資料類型：String

存取類型：讀取/寫入

限定符：[Not_null]

指定套件內的程式 (PackageID) 公告。

`RemoteClientFlags`

資料類型：UInt32

存取類型：讀取/寫入

限定符：[bits]

旗標，指定當用戶端在本機或遠端連線到發佈點時，程式應該如何執行。可能的值如下所示。預設值為 48。

十六進位 (位)	描述
0x00000001 (0)	BATTERY_POWER。使用電池電源執行程式。此值目前未使用。
0x00000002 (1)	RUN_FROM_CD。從CD執行程式。此值目前未使用。
0x00000004 (2)	DOWNLOAD_FROM_CD。從 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

存取類型：只讀

限定符：[read]

廣告來源網站的三個字母網站碼。

`TimeFlags`

資料類型：UInt32

存取類型：只讀

限定符：[讀取，位]

保留給內部使用。在時間相關屬性中複製資訊的旗標。可能的值如下所示。例如，當等於 true時PresentTimeEnabled，會設定ENABLE_PRESENT。

十六進位 (位)	描述
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 伺服器開發需求。

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-06-06

共用方式為

SMS_Advertisement 伺服器 WMI 類別

語法

方法

屬性

ActionInProgress

AdvertFlags

AdvertisementID

AdvertisementName

AssignedScheduleEnabled

AssignedScheduleIsGMT

AssignmentID

CollectionID

Comment

DeviceFlags

ExpirationTime

ExpirationTimeEnabled

ExpirationTimeIsGMT

HierarchyPath

IncludeSubCollection

ISVData

ISVDataSize

ISVString

MandatoryCountdown

OfferType

PackageID

PresentTime

PresentTimeEnabled

PresentTimeIsGMT

Priority

ProgramName

RemoteClientFlags

SourceSite

TimeFlags

註解

需求

運行時間需求

開發需求

意見反應

其他資源

`ActionInProgress`

`AdvertFlags`

`AdvertisementID`

`AdvertisementName`

`AssignedScheduleEnabled`

`AssignedScheduleIsGMT`

`AssignmentID`

`CollectionID`

`Comment`

`DeviceFlags`

`ExpirationTime`

`ExpirationTimeEnabled`

`ExpirationTimeIsGMT`

`HierarchyPath`

`IncludeSubCollection`

`ISVData`

`ISVDataSize`

`ISVString`

`MandatoryCountdown`

`OfferType`

`PackageID`

`PresentTime`

`PresentTimeEnabled`

`PresentTimeIsGMT`

`Priority`

`ProgramName`

`RemoteClientFlags`

`SourceSite`

`TimeFlags`