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í Duration vlastnost, 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