SMS_Advertisement 伺服器 WMI 類別

發行項
04/04/2023

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伺服器開發需求。

共用方式為

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`

註解

需求

執行時間需求

開發需求

意見反應

其他資源