Serverová třída služby WMI SMS_Program
Třída SMS_Program WMI (Windows Management Instrumentation) je serverová třída poskytovatele serveru SMS v Configuration Manager, která představuje program nebo příkaz, který se má spustit při distribuci softwaru do klientského počítače.
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_Program : SMS_BaseClass
{
UInt32 ActionInProgress;
String ApplicationHierarchy;
String CommandLine;
String Comment;
String DependentProgram;
String Description;
UInt32 DeviceFlags;
String DiskSpaceReq;
String DriveLetter;
UInt32 Duration;
UInt8 ExtendedData[];
UInt32 ExtendedDataSize;
UInt8 Icon[];
UInt32 IconSize;
UInt8 ISVData[];
UInt32 ISVDataSize;
String ISVString;
String MSIFilePath
String MSIProductID
String PackageID;
String PackageName
UInt32 PackageType
String PackageVersion
UInt32 ProgramFlags;
String ProgramName;
String RemovalKey;
String Requirements;
UInt32 SecuredTypeID
SMS_OS_Details SupportedOperatingSystems[];
UInt32 TransformReadiness=0;
Datetime TransformAnalysisDate;
String TransformDtID;
String WorkingDirectory;
};
Metody
Třída SMS_Program nedefinuje žádné metody.
Vlastnosti
ActionInProgress
Datový typ: UInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [čtení, výčet]
Aktuální akce prováděná s balíčkem, který je přidružen k programu Configuration Manager. Možné hodnoty jsou:
| Hodnota | Popis |
|---|---|
| 0 | ŽÁDNÝ |
| 1 | AKTUALIZACE |
| 2 | PŘIDAT |
| 3 | ODSTRANIT |
Tato vlastnost v klauzuli WHERE slouží k odfiltrování programů, které byly označeny k odstranění, ale ještě nebyly odstraněny. Další informace najdete v části Poznámky dále v tomto tématu.
ApplicationHierarchy
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Hierarchie aplikací pro program Výchozí hodnota je "".
CommandLine
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Příkazový řádek, který se spustí při spuštění programu. Výchozí hodnota je "".
Comment
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Komentář, který popisuje program v konzole Configuration Manager. Výchozí hodnota je "".
DependentProgram
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Formátovaný textový řetězec definující jakýkoli program, který se má spustit před spuštěním tohoto programu. Formát je definován jako <PackageID>;;<ProgramName>. Pokud je program ve stejném balíčku, volající aplikace může jednoduše zadat ;;<ProgramName>. Výchozí hodnota je "".
Závislost se udržuje pouze při prvním spuštění programu. Po spuštění programu se závislost ignoruje. Nemůžete například vytvořit opakovanou naplánovanou úlohu, pro kterou je zachována závislost pro každé spuštění programu.
Description
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Nepoužívá se.
DeviceFlags
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Příznaky popisující zařízení přidružené k programu. Možné hodnoty jsou:
| Š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. |
DiskSpaceReq
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Přibližné místo na disku, které program vyžaduje. Formát je "<size><KB|MB|GB>". Výchozí hodnota je "".
Tyto informace se používají v konzole Configuration Manager a v reklamě k poskytování upozornění na požadavky na místo na disku programu. Uživatel se pak může rozhodnout přijmout inzerování nebo nejprve provést úlohu správy disků.
DriveLetter
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [SizeLimit("1"), Range("a-z")]
Písmeno jednotky (jeden znak v rozsahu a–z), na který program namapuje a ze kterého běží. Výchozí hodnota je "".
Duration
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Přibližná doba provádění programu v minutách na klientském počítači. Tuto hodnotu zadejte jako celé číslo větší nebo rovno 0 (výchozí) nebo jako Neznámé (nedoporučuje se). Pokud je vlastnost nastavená na Neznámý, Configuration Manager nastaví maximální povolenou dobu běhu na 720 minut (12 hodin). Další informace najdete v části Poznámky dále v tomto tématu.
Poznámka
V klientských počítačích se zadaná hodnota pro publikované programy zobrazí v Run Advertised Programs Ovládací panely.
ExtendedData
Datový typ: UInt8 Array
Typ přístupu: Čtení/zápis
Kvalifikátory: [velký, líný]
Objekt blob XML pro nasazení image.
ExtendedDataSize
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
Rozšířená velikost dat v bajtech Výchozí hodnota je 0.
Icon
Datový typ: UInt8 Array
Typ přístupu: Čtení/zápis
Kvalifikátory: [velké]
Informace o ikoně aplikace, které jsou zobrazeny v konzole Configuration Manager.
IconSize
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
Velikost ikony programu v bajtech Pokud chcete ikonu vymazat, nastavte tuto vlastnost na hodnotu 0.
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 objektu SMS_Program .
Pro data isV neexistují žádná omezení ani definované formáty. Je však důležité nepřepsat vlastnost po vytvoření vlastnictví ISV. Vaše aplikace by měla nejprve přečíst existující data v této vlastnosti. Pokud data nepatří do aplikace, neměla by se upravovat. Do dat programu byste měli zahrnout identifikátor, aby bylo možné snadno vytvořit vlastnictví.
ISVDataSize
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
Velikost dat uložených v ISVDatabajtech 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
MSIFilePath
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Cesta k souboru balíčku Instalační služby systému Windows, ke kterému je program přidružen. Výchozí hodnota je "".
MSIProductID
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
ID produktu balíčku Instalační služby systému Windows, ke kterému je program přidružený. Výchozí hodnota je "".
PackageID
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [key, Not_null]
ID existujícího balíčku, ke kterému se má program přidružit. Další informace najdete v části Poznámky dále v tomto tématu.
PackageName
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [Žádné]
Název balíčku, do který program patří.
PackageType
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [Žádné]
Typ balíčku, do který program patří.
| Hodnota | Popis |
|---|---|
| 0 | Běžný balíček distribuce softwaru. |
| 3 | Balíček ovladače. |
| 4 | Balíček pořadí úkolů. |
| 5 | Balíček aktualizace softwaru. |
| 6 | Balíček nastavení zařízení. |
| 257 | Balíček image. |
| 258 | Balíček spouštěcí image. |
| 259 | Instalační balíček operačního systému. |
PackageVersion
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [Žádné]
Verze balíčku, do které program patří.
ProgramFlags
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [bity]
Příznaky identifikující charakteristiky instalace programu. Možné hodnoty jsou uvedeny níže. Výchozí hodnoty jsou EVERYUSER, USEUNCPATH, USERCONTEXT a UNATTENDED.
Poznámka
Pokud používáte SMS_Program programově, ujistěte se, že nejsou vybrány žádné konfliktní hodnoty. Například NOUSERLOGGEDIN a USERCONTEXT by se neměly používat společně.
Možné hodnoty jsou:
| Šestnáctkové (bitové) | Popis |
|---|---|
| 0x00000001 (0) | AUTHORIZED_DYNAMIC_INSTALL. Program je autorizován pro dynamickou instalaci. |
| 0x00000002 (1) | USECUSTOMPROGRESSMSG. Pořadí úkolů zobrazuje zprávu uživatelského rozhraní o vlastním průběhu. |
| 0x00000010 (4) | DEFAULT_PROGRAM. Toto je výchozí program. |
| 0x00000020 (5) | DISABLEMOMALERTONRUNNING. Zakáže upozornění MOM při spuštění programu. |
| 0x00000040 (6) | MOMALERTONFAIL. Vygeneruje upozornění MOM, pokud program selže. |
| 0x00000080 (7) | RUN_DEPENDANT_ALWAYS. Pokud je tato možnost nastavená, měla by se vždy spustit okamžitá závislost tohoto programu. |
| 0x00000100 (8) | WINDOWS_CE. Označuje program zařízení. Pokud je program nastavený, desktopovým klientům se program nenabídá. |
| 0x00000200 (9) | Tato hodnota se nepoužívá. |
| 0x00000400 (10) | ODPOČÍTÁVÁNÍ. Dialogové okno odpočítávání se nezobrazí. |
| 0x00000800 (11) | FORCERERUN. Tato hodnota se nepoužívá. |
| 0x00001000 (12) | ZAKÁZÁN. Program je zakázán. |
| 0x00002000 (13) | BEZOBSLUŽNÉ. Program nevyžaduje žádnou interakci uživatele. |
| 0x00004000 (14) | USERCONTEXT. Program se dá spustit jenom tehdy, když je přihlášený uživatel. |
| 0x00008000 (15) | OPRÁVNĚNÍ SPRÁVCE. Program musí být spuštěn jako místní účet správce. |
| 0x00010000 (16) | KAŽDÝ UŽIVATEL. Program musí spustit každý uživatel, pro kterého je platný. Platí pouze pro povinné úlohy. |
| 0x00020000 (17) | NOUSERLOGGEDIN. Program se spustí pouze v případě, že není přihlášen žádný uživatel. |
| 0x00040000 (18) | OKTOQUIT. Program restartuje počítač. |
| 0x00080000 (19) | OKTOREBOOT. Configuration Manager restartuje počítač po úspěšném dokončení programu. |
| 0x00100000 (20) | USEUNCPATH. Pro přístup k distribučnímu bodu použijte cestu UNC (bez písmene jednotky). |
| 0x00200000 (21) | PERSISTCONNECTION. Zachová připojení k jednotce zadané ve vlastnosti DriveLetter. Nesmí být nastaven příznak bitu USEUNCPATH. |
| 0x00400000 (22) | RUNMINIMIZED. Spusťte program jako minimalizované okno. |
| 0x00800000 (23) | RUNMAXIMIZED. Spusťte program jako maximalizované okno. |
| x01000000 (24) | HIDEWINDOW. Skryjte okno programu. |
| 0x02000000 (25) | OKTOLOGOFF. Po úspěšném dokončení programu odhlaste uživatele. |
| 0x04000000 (26) | RUNACCOUNT. Tato hodnota se nepoužívá. |
| 0x08000000 (27) | ANY_PLATFORM. Kontrola přepsání podpory platformy |
| 0x10000000 (28) | STILL_RUNNING. Tato hodnota se nepoužívá. |
| 0x20000000 (29) | SUPPORT_UNINSTALL. Po vypršení platnosti inzerce spusťte odinstalaci z klíče registru. |
| 0x40000000 (30) | Platforma se nepodporuje. |
| 0x80000000 (31) | SHOW_IN_ARP. Tato hodnota se nepoužívá. |
ProgramName
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [key, Not_null]
Jedinečný název, který představuje tento program.
RemovalKey
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Klíč registru, který identifikuje odinstalační skript programu. Skript se musí nacházet v cestě HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall registru. Výchozí hodnota je "".
Requirements
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Popis všech dalších požadavků programu. Výchozí hodnota je "".
SecuredTypeID
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [Žádné]
Zabezpečený typ souvisejícího balíčku.
SupportedOperatingSystems
Datový typ: SMS_OS_Details Array
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
SMS_OS_Details Objekty serverové třídy služby WMI představující operační systémy, na kterých lze program spustit.
Pokud ve ProgramFlags vlastnosti nezadáte ANY_PLATFORM, musíte zadat jeden nebo více podporovaných operačních systémů. Serverová třída služby WMI SMS_SupportedPlatforms definuje seznam platforem, které Configuration Manager podporují.
TransformAnalysisDate
Datový typ: DateTime
Typ přístupu: Čtení/zápis
Kvalifikátory: [Žádné]
Pouze pro interní použití.
TransformDtID
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [Žádné]
Pouze pro interní použití.
TransformReadiness
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [Žádné]
Pouze pro interní použití.
WorkingDirectory
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Umístění, ze kterého se program spouští. Výchozí hodnota je "".
Pracovní adresář může být absolutní cesta na klientovi nebo relativní cesta ke složce distribučního bodu, která obsahuje balíček. Pokud pracovní adresář není zadaný, Configuration Manager použije výchozí složku distribučního bodu.
Poznámky
Pro tuto třídu neexistují žádné speciální kvalifikátory tříd. 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í.
Program je vždy spojen s nadřazeným balíčkem a obvykle představuje instalační program balíčku. Ke stejnému balíčku lze přidružit více než jeden program. Aplikace použije PackageID vlastnost k vytvoření tohoto přidružení. Po vytvoření objektu SMS_Program nemůže aplikace tuto vlastnost změnit. Chcete-li přidružit program k jinému balíčku, musí aplikace odstranit objekt a vytvořit nový objekt s novou PackageID hodnotou.
Když vaše aplikace odstraní objekt, neodstraní SMS_Program se, dokud se neodstraní jeho související součásti, například reklamy. Místo toho Configuration Manager nastaví ActionInProgress vlastnost DELETE (3) a označí program k odstranění. Pokud chcete zajistit, aby dotaz nenačítal programy označené k odstranění, přidejte tento případ do klauzule WHERE.
Důležité
Pokud používáte časové období údržby pro kolekci, ve které je program spuštěn, může dojít ke konfliktu, pokud je hodnota Duration vlastnosti delší než plánované časové období údržby. Pokud je tato vlastnost nastavena na Hodnotu Neznámý, program se spustí během časového období údržby, ale bude spuštěn až do dokončení nebo selhání po zavření časového období údržby.
Doporučujeme nenastavovat Duration vlastnost na Hodnotu Neznámý, protože tato vlastnost se používá k následujícím dvěma důležitým účelům:
Chcete-li sledovat výsledky programu.
Chcete-li zjistit, zda bude program spuštěn po definování časových období údržby na klientských počítačích.
Pokud vaše aplikace nastaví
Durationvlastnost, ale doba běhu programu tuto dobu překročí, pak Configuration Manager program přestane monitorovat, ale program neukončí. To Configuration Manager umožňuje pokračovat s dalšími funkcemi distribuce softwaru, jako je spouštění jiných inzerovaných programů. Manažer:Zastavte program.
Uvolněte všechny jednotky, které byly namapovány pro inzerovaný program.
Uvolněte všechna síťová připojení vytvořená pro inzerovaný program.
Bezplatné prostředky operačního systému používané Configuration Manager při spuštěných inzerovaných programech.
Další informace najdete v tématu O časových obdobích údržby.
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.
Viz taky
Serverová třída služby WMI SMS_Package
Jak vytvořit balíček
Jak vytvořit program
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro