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

註解

需求

執行時間需求

開發需求

意見反應

意見反應

其他資源

`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`