SMS_Advertisement 伺服器 WMI 類別

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