Serverová třída služby WMI SMS_Advertisement
Třída SMS_Advertisement WMI (Windows Management Instrumentation) je serverová třída poskytovatele serveru SMS v Configuration Manager, která představuje reklamu používanou k oznámení programů softwarových balíčků, které jsou k dispozici pro spuštění na klientech.
Následující syntaxe je zjednodušená z kódu MOF (Managed Object Format) a zahrnuje všechny zděděné vlastnosti.
Syntaxe
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;
};
Metody
Následující tabulka uvádí metody ve SMS_Advertisement třídě .
| Metoda | Popis |
|---|---|
| Metoda GetAdvertisements ve třídě SMS_Advertisement | Získá ID inzerce, které jsou cílem prostředku. |
| Metoda GetNextID v SMS_Advertisement třídy | Načte číslo ID, které se použije pro další vytvořenou reklamu. |
| Metoda RiskyDeploymentStatusMessage ve třídě SMS_Advertisement | Odešle stavovou zprávu o nasazení uživatele do rizikové kolekce. |
| Metoda SetNextID v SMS_Advertisement třídy | Nastaví číslo ID, které se použije pro další vytvořenou reklamu. |
| Metoda SetSourceSite v SMS_Advertisement třídy | Nastaví zdrojový kód lokality pro inzerování. |
| Metoda Unlock v SMS_Advertisement třídy | Nastaví zdrojový web na aktuální web a odemkne inzerování. Upozornění: Tato metoda je zastaralá. |
Vlastnosti
ActionInProgress
Datový typ: UInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [čtení, výčet]
Aktuální akce, kterou s balíčkem provádí Configuration Manager. Možné hodnoty jsou:
| Hodnota | Popis |
|---|---|
| 0 | ŽÁDNÝ |
| 1 | AKTUALIZACE |
| 2 | Přidat |
AdvertFlags
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [bity]
Příznaky označující, jak se má oznámení inzerce uživateli oznamovat. Možné hodnoty jsou uvedeny níže. Výchozí hodnota je 0.
| Šestnáctkové (bitové) | Popis |
|---|---|
| 0x00000020 (5) | OKAMŽITÉ. Okamžitě oznamte uživateli inzerci. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Oznamte uživateli inzerování při spuštění systému. |
| 0x00000200 (9) | ONUSERLOGON. Oznamte uživateli inzerci při přihlášení. |
| 0x00000400 (10) | ONUSERLOGOFF. Oznamte uživateli inzerci při odhlášení. |
| 0x00001000 (12) | VOLITELNÉPREDOWNLOAD. Pokud vybraná architektura a jazyk odpovídá architektuře a jazyku klienta, obsah balíčku se stáhne předem. |
| 0x00008000 (15) | WINDOWS_CE. Inzerování je určené pro klienta zařízení. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Tyto informace platí pro System Center 2012 Configuration Manager SP1 nebo novější a System Center 2012 R2 Configuration Manager nebo novější. |
| 0x00020000 (17) | DONOT_FALLBACK. Nepoužívejte návrat k nechráněným distribučním bodům. |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE. Pořadí úkolů je dostupné pro vyměnitelné médium a bod služby PXE (Pre-Boot Execution Environment). |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Přepište časové intervaly údržby při oznámení reklamy uživateli. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Restartujte počítač mimo časové období údržby. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Oznamte uživateli inzerci s povolenou funkcí Wake On LAN. |
| 0x00800000 (23) | SHOW_PROGRESS. Oznamte uživateli inzerci s průběhem pořadí úkolů. |
| 0x02000000 (25) | NO_DISPLAY. Uživatel by neměl spouštět programy nezávisle na přiřazení. |
| 0x04000000 (26) | ONSLOWNET. Přiřazení jsou povinná u pomalého síťového připojení. |
| 0x10000000 (28) | TARGETTOWINPE. Zaměřte toto nasazení pouze na WinPE. |
| 0x20000000 (29) | HIDDENINWINPE. Zaměřte toto nasazení pouze na WinPE, ale ve WinPE skryjte. Může ji použít pouze proměnná TS SMSTSPreferredAdvertID. |
Tyto příznaky musí být koordinovány s příznaky, které jsou určeny ve ProgramFlags vlastnosti inzerovaného programu. Pokud například nastavíte ONUSERLOGOFF, musí být v programu nastaven příznak NOUSERLOGGEDIN. Pokud se nastavení příznaku neshoduje, program se neinzeruje. Další informace najdete v tématu SMS_Program Serverová třída služby WMI.
Nastavení IMMEDIATE, ONUSERLOGON nebo ONUSERLOGOFF nebo poskytnutí hodnoty AssignedSchedule činí inzerovaný program povinným. Povinný program se spustí automaticky poté, co klient obdrží inzerci. Klient nemůže odmítnout ani odložit instalaci.
Bity NO_DISPLAY a ONSLOWNET nastavte pouze v případě, že je nastaven bit IMMEDIATE, ONUSERLOGON nebo ONUSERLOGOFF nebo pokud má program hodnotu AssignedSchedule .
Nastavte NO_DISPLAY, pokud nechcete, aby uživatel spouštět programy nezávisle na přiřazení. Pokud tento příznak nenastavíte, reklama se zobrazí v seznamu inzerovaných oznámení a může být spuštěna nezávisle na přiřazení. Program může být stále povinný.
Nastavte ONSLOWNET, když jsou přiřazení povinná přes pomalé připojení k síti, například když se počítač připojuje pomocí modemu.
AdvertisementID
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [key, ResID(801), ResDLL("SMS_RSTT.dll")]
Jedinečný automaticky vygenerovaný klíč, který identifikuje inzerování. Výchozí hodnota je "".
AdvertisementName
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [Not_null]
Jedinečný uživatelsky popisný název pro inzerování.
AssignedSchedule
Datový typ: SMS_ScheduleToken Array
Typ přístupu: Čtení/zápis
Kvalifikace: [max(15), líný]
SMS_ScheduleToken Objekty serverové třídy služby WMI označující čas, kdy se inzerce na klientech stane povinnou.
AssignedScheduleEnabled
Datový typ: Boolean
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
true pokud je plán definovaný ve AssignedSchedule vlastnosti aktivní. Výchozí hodnota je false.
AssignedScheduleIsGMT
Datový typ: Boolean
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
true pokud je plán definovaný ve AssignedSchedule vlastnosti v univerzálním čase metriky (UMT). Výchozí hodnota je false.
AssignmentID
Datový typ: UInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
ID přiřazení přidruženého k inzerci.
CollectionID
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [Not_null]
Existující kolekce, na kterou je cílem inzerce.
Comment
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Jednoduchý popis nebo poznámka o reklamě. Výchozí hodnota je "".
DeviceFlags
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Příznaky popisující zařízení Možné hodnoty jsou uvedeny níže. Výchozí hodnota je 0.
| Šestnáctkové (bitové) | Popis |
|---|---|
| 0x01000000 (24) | Vždy přiřaďte programu klientovi. |
| 0x02000000 (25) | Přiřaďte ho jenom v případě, že je zařízení aktuálně připojené k připojení s velkou šířkou pásma (ve výchozím nastavení je to více než 60 kB/s). |
| 0x04000000 (26) | Přiřaďte ho jenom v případě, že je zařízení ukotvené, to znamená, že je připojené k ploše, která používá ActiveSync. |
ExpirationTime
Datový typ: DateTime
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Datum a čas, kdy už inzerce není pro klienty k dispozici. Výchozí hodnota je 1990010100000.000000+***.
ExpirationTimeEnabled
Datový typ: Boolean
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
true pokud platnost inzerce vyprší v čase určeném ExpirationTime vlastností. Výchozí hodnota je false.
ExpirationTimeIsGMT
Datový typ: Boolean
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
true pokud je čas definovaný ve ExpirationTime vlastnosti v UMT. Výchozí hodnota je false.
HierarchyPath
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Vyhrazena.
IncludeSubCollection
Datový typ: Boolean
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
true (výchozí) pokud je inzerování inzerováno do dílčích kolekcí zadané kolekce.
ISVData
Datový typ: Uint8 Array
Typ přístupu: Čtení/zápis
Kvalifikátory: [velký, líný]
Informace, které umožňují jednomu isV ukládat data týkající se SMS_Program instance. Pro tato data neexistují žádná omezení ani definované formáty. Je však důležité nepřepsat vlastnost po vytvoření vlastnictví ISV. Volající aplikace by proto měla nejprve přečíst existující data v této vlastnosti. Pokud data nepatří do aplikace, neměla by se měnit. Každý výrobce softwaru nebo vlastník aplikace, který tuto vlastnost používá, by měl v datech obsahovat identifikátor, aby bylo možné snadno zjistit vlastnictví.
ISVDataSize
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
Velikost dat reprezentovaných ISVData vlastností Výchozí hodnota je 0.
ISVString
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: žádné
Řetězec pro rozšiřitelnost partnera
MandatoryCountdown
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Doba trvání v minutách, aby se zobrazilo oznámení o povinném odpočítávání plánu nasazení operačního systému uživateli. Výchozí hodnota je 0.
OfferType
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [výčet]
Typ inzerce, který označuje, že inzerce je cílená na uživatele.
| Hodnota | Popis |
|---|---|
| 0 | Povinný |
| 2 | Dostupná |
PackageID
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [Not_null]
ID existujícího balíčku přidruženého k inzerci. Hodnota musí být velkými písmeny.
PresentTime
Datový typ: DateTime
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Datum a čas, kdy je inzerce zpřístupněna klientům. Výchozí hodnota je 1990010100000.000000+***.
PresentTimeEnabled
Datový typ: Boolean
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
true(výchozí) pokud je aktuální čas vynucený Configuration Manager.
PresentTimeIsGMT
Datový typ: Boolean
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
true pokud je čas definovaný ve PresentTime vlastnosti v UMT. Výchozí hodnota je false.
Priority
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [výčet]
Priorita použitá při replikaci inzerování na podřízené weby. Možné hodnoty jsou uvedeny níže. Výchozí hodnota je NORMAL (2).
| Hodnota | Popis |
|---|---|
| 1 | VYSOKÉ |
| 2 | NORMÁLNÍ |
| 3 | Nízké |
ProgramName
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [Not_null]
Program v rámci zadaného balíčku (PackageID), který má být inzerován.
RemoteClientFlags
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [bity]
Příznaky určující, jak se má program spustit, když je klient připojen místně nebo vzdáleně k distribučnímu bodu. Možné hodnoty jsou uvedeny níže. Výchozí hodnota je 48.
| Šestnáctkové (bitové) | Popis |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Spusťte program pomocí napájení z baterie. Tato hodnota se aktuálně nepoužívá. |
| 0x00000002 (1) | RUN_FROM_CD. Spusťte program z disku CD. Tato hodnota se aktuálně nepoužívá. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Stáhněte si program z DISKU CD. Tato hodnota se aktuálně nepoužívá. |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT. Spusťte program z místního distribučního bodu. |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT. Stáhněte si program z místního distribučního bodu. |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT. Pokud neexistuje žádný místní distribuční bod, program nespouštět. |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT. Stáhněte program ze vzdáleného distribučního bodu. |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT. Spusťte program ze vzdáleného distribučního bodu. |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Stáhněte si program na vyžádání z místního distribučního bodu. To platí jenom pro pořadí úkolů. |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Stáhněte si program na vyžádání ze vzdáleného distribučního bodu. To platí jenom pro pořadí úkolů. |
| x00000400 (10) | BALLOON_REMINDERS_REQUIRED. Připomenutí bublinou jsou povinná. |
| 0x00000800 (11) | RERUN_ALWAYS. Program vždy znovu spusťte. |
| 0x00001000 (12) | RERUN_NEVER. Program už nikdy nespustíte znovu. |
| 0x00002000 (13) | RERUN_IF_FAILED. Pokud se dříve spuštění nepovedlo, spusťte program znovu. |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED. Pokud bylo spuštění dříve úspěšné, spusťte program znovu. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Tyto informace platí pro System Center 2012 Configuration Manager SP1 nebo novější a System Center 2012 R2 Configuration Manager nebo novější. |
| 0x00020000 (17) | T_FALLBACK Tyto informace platí pro System Center 2012 Configuration Manager SP1 nebo novější a System Center 2012 R2 Configuration Manager nebo novější. |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK Tyto informace platí pro System Center 2012 Configuration Manager SP1 nebo novější a System Center 2012 R2 Configuration Manager nebo novější. |
SourceSite
Datový typ: String
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Třímísmenný kód lokality, ze které inzerování pochází.
TimeFlags
Datový typ: UInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read, bits]
Vyhrazeno pro interní použití. Příznaky, které duplikují informace ve vlastnostech souvisejících s časem. Možné hodnoty jsou uvedeny níže. Například ENABLE_PRESENT se nastaví, když PresentTimeEnabled se rovná true.
| Šestnáctkové (bitové) | Popis |
|---|---|
| 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 |
Poznámky
Mezi kvalifikátory tříd pro tuto třídu patří:
Zabezpečené
Další informace o kvalifikátorech tříd a kvalifikátorech vlastností zahrnutých v části Vlastnosti najdete v tématu Configuration Manager třídy a kvalifikátory vlastností.
I když neexistují žádné další vlastnosti klíče, vlastnosti
AdvertisementName,CollectionID,PackageIDaProgramNamejsou kvalifikovány jako NOT_NULL a hodnoty musí být zadány. Aplikace nemůže tyto vlastnosti aktualizovat po vytvoření instance třídy. Pokud chcete tyto hodnoty změnit, aplikace musí odstranit instanci a vytvořit novou instanci se správnými hodnotami.
Požadavky
Požadavky na modul runtime
Další informace najdete v tématu Configuration Manager Server Runtime Requirements.
Požadavky na vývoj
Další informace najdete v tématu Požadavky na vývoj Configuration Manager Serveru.