Třída WMI serveru SMS_Program Server

Třída SMS_Program rozhraní WMI (Windows Management Instrumentation) je serverová třída poskytovatele SMS v nástroji 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 pomocí nástroje Configuration Manager. Možné hodnoty jsou:

Hodnota	Popis
0	ŽÁDNÉ
1	AKTUALIZACE
2	PŘIDAT
3	ODSTRANIT

Pomocí této vlastnosti v klauzuli WHERE můžete odfiltrovat programy, které jsou označené k odstranění, ale ještě nebyly odstraněné. Další informace najdete dál v tomto tématu v části Poznámky.

ApplicationHierarchy Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: Žádné

Hierarchie aplikací programu. Výchozí hodnota je "".

CommandLine Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: Žá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

Kvalifikace: Žádné

Komentář popisující program v konzole nástroje Configuration Manager. Výchozí hodnota je "".

DependentProgram Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: Žádné

Formátovaný textový řetězec definující jakýkoli program, který by měl být spuštěn 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 specifikovat ;;<ProgramName>. Výchozí hodnota je "".

Závislost je zachována pouze při prvním spuštění programu. Po spuštění programu je závislost ignorována. 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

Kvalifikace: Žádné

Nepoužívá se.

DeviceFlags Datový typ: UInt32

Typ přístupu: čtení/zápis

Kvalifikace: Žádné

Příznaky popisující zařízení přidružené k programu. Možné hodnoty jsou:

Šestnáctková (bitová)	Popis
0x01000000 (24)	Program vždy přiřaďte klientovi.
0x02000000 (25)	Přiřaďte pouze v případě, že je zařízení právě připojené k širokopásmovému připojení (výchozí nastavení nad 60 kb/s).
0x04000000 (26)	Přiřaďte pouze v případě, že je zařízení v dokovací stanici, to znamená, že je připojené k ploše, která používá ActiveSync.

DiskSpaceReq Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: Žádné

Přibližné místo na disku, které program vyžaduje. Formát je "<velikost><KB|MB|GB".> Výchozí hodnota je "".

Tyto informace se používají v konzole nástroje Configuration Manager a v reklamě k poskytování výstrah o požadavcích na místo na disku programu. Uživatel se pak může rozhodnout, jestli přijme inzerci nebo nejprve provede nějakou úlohu správy disku.

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é je program mapován a ze kterého se spouští. Výchozí hodnota je "".

Duration Datový typ: UInt32

Typ přístupu: čtení/zápis

Kvalifikace: Žádné

Přibližná doba provádění programu v klientském počítači (v minutách). Tuto hodnotu zadejte jako celé číslo větší nebo rovno 0 (výchozí) nebo Neznámá (nedoporučuje se). Pokud je vlastnost nastavená na hodnotu Neznámá, nastaví Configuration Manager maximální povolenou dobu běhu na 720 minut (12 hodin). Další informace najdete dál v tomto tématu v části Poznámky.

Poznámka

V klientských počítačích se zadaná hodnota pro publikované programy zobrazí v Run Advertised Programs okně Ovládací panely.

ExtendedData Datový typ: UInt8 Matice

Typ přístupu: čtení/zápis

Kvalifikátory: [velký, líný]

Objekt blob XML pro nasazení obrázků.

ExtendedDataSize Datový typ: UInt32

Typ přístupu: čtení/zápis

Kvalifikace: [líný]

Rozšířená velikost dat v bajtech. Výchozí hodnota je 0.

Icon Datový typ: UInt8 Matice

Typ přístupu: čtení/zápis

Kvalifikace: [velký]

Informace o ikoně přidružené k ikoně programu, jak se zobrazují v konzole nástroje Configuration Manager.

IconSize Datový typ: UInt32

Typ přístupu: čtení/zápis

Kvalifikace: [líný]

Velikost ikony aplikace v bajtech. Nastavením této vlastnosti na hodnotu 0 ikonu vymažete.

ISVData Datový typ: UInt8 Matice

Typ přístupu: čtení/zápis

Kvalifikátory: [velký, líný]

Informace, které umožňují jednomu nezávislému softwaru ukládat data vztahující se k SMS_Program objektu.

Pro data ISV neexistují žádná omezení ani nejsou definované žádné formáty. Je ale důležité, abyste vlastnost po vytvoření vlastnictví ISV nepřepsali. Aplikace by měla nejprve načíst existující data v této vlastnosti. Pokud data nepatří do aplikace, neměla by se upravovat. V datech programu byste měli uvést identifikátor, aby bylo možné snadno určit vlastnictví.

ISVDataSize Datový typ: UInt32

Typ přístupu: čtení/zápis

Kvalifikace: [líný]

Velikost dat uložených v bajtech ISVData Výchozí hodnota je 0.

ISVString Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: žádné

Řetězec pro rozšiřitelnost partnera.

MSIFilePath Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: Žá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

Kvalifikace: Žá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

Kvalifikace: [klíč, Not_null]

ID existujícího balíčku, ke kterému se má program přidružit. Další informace najdete dál v tomto tématu v části Poznámky.

PackageName Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: [Žádné]

Název balíčku, do kterého program patří.

PackageType Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: [Žádné]

Typ balíčku, do kterého 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 obrázků.
258	Balíček spouštěcí bitové kopie.
259	Instalační balíček operačního systému.

PackageVersion Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: [Žádné]

Verze balíčku, do kterého program patří.

ProgramFlags Datový typ: UInt32

Typ přístupu: čtení/zápis

Kvalifikátory: [bits]

Příznaky identifikující instalační charakteristiky programu. Možné hodnoty jsou uvedené níže. Výchozí hodnoty jsou EVERYUSER, USEUNCPATH, USERCONTEXT a UNATTENDED.

Poznámka

SMS_Program Při použití programu se ujistěte, ž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 oprávněn k dynamické instalaci.
0x00000002 (1)	USECUSTOMPROGRESSMSG. V pořadí úkolů se zobrazuje zpráva vlastního průběhu uživatelského rozhraní.
0x00000010 (4)	DEFAULT_PROGRAM. Toto je výchozí program
0x00000020 (5)	DISABLEMOMALERTONRUNNING. Zakáže upozornění MOM při běhu programu.
0x00000040 (6)	MOMALERTONFAIL. Generuje upozornění MOM v případě selhání programu.
0x00000080 (7)	RUN_DEPENDANT_ALWAYS. Je-li tato možnost nastavena, měla by být vždy spuštěna bezprostřední závislá položka tohoto programu.
0x00000100 (8)	WINDOWS_CE. Označuje program zařízení. Pokud je tato možnost nastavená, není program nabídnut desktopovým klientům.
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ÁNO. Program je zakázán.
0x00002000 (13)	BEZ DOZORU. Program nevyžaduje žádnou interakci uživatele.
0x00004000 (14)	UŽIVATELSKÝ KONTEXT. Program lze spustit pouze v případě, že je uživatel přihlášen.
0x00008000 (15)	ADMINRIGHTS. Program musí být spuštěn pod účtem místního správce.
0x00010000 (16)	EVERYUSER. Program musí spustit každý uživatel, pro kterého je platný. Platí pouze pro povinná pracovní místa.
0x00020000 (17)	NOUSERLOGGEDIN. Program je spuštěn pouze v případě, že není přihlášen žádný uživatel.
0x00040000 (18)	OKTOQUIT. Program restartuje počítač.
0x00080000 (19)	OKNARESTARTOVAT. Po úspěšném ukončení programu nástroj Configuration Manager restartuje počítač.
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 PísmenoJednotky. Nesmí být nastaven bitový příznak USEUNCPATH.
0x00400000 (22)	RUNMINIMIZED. Spusťte aplikaci jako minimalizované okno.
0x00800000 (23)	RUNMAXIMIZED. Spusťte aplikaci jako maximalizované okno.
x01000000 (24)	HIDEWINDOW. Skryje okno programu.
0x02000000 (25)	OKTOLOGOFF. Po úspěšném dokončení programu se odhlaste z uživatele.
0x04000000 (26)	RUNACCOUNT. Tato hodnota se nepoužívá.
0x08000000 (27)	ANY_PLATFORM. Přepsat kontrolu podpory platformy.
0x10000000 (28)	STILL_RUNNING. Tato hodnota se nepoužívá.
0x20000000 (29)	SUPPORT_UNINSTALL. Po vypršení platnosti oznámení spusťte odinstalaci z klíče registru.
0x40000000 (30)	Platforma není podporovaná.
0x80000000 (31)	SHOW_IN_ARP. Tato hodnota se nepoužívá.

ProgramName Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: [klíč, Not_null]

Jedinečný název, který představuje tento program

RemovalKey Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: Žádné

Klíč registru, který identifikuje odinstalační skript programu. Skript musí být umístěn v cestě registru HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall . Výchozí hodnota je "".

Requirements Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: Žádné

Popis případných dalších požadavků programu. Výchozí hodnota je "".

SecuredTypeID Datový typ: UInt32

Typ přístupu: čtení/zápis

Kvalifikace: [Žádné]

Zabezpečený typ souvisejícího balíčku.

SupportedOperatingSystems Datový typ: SMS_OS_Details Matice

Typ přístupu: čtení/zápis

Kvalifikace: [líný]

SMS_OS_Details Server Objekty třídy WMI představující operační systémy, ve kterých může program běžet.

Pokud do vlastnosti nezadáte ANY_PLATFORM ProgramFlags , musíte zadat jeden nebo více podporovaných operačních systémů. SMS_SupportedPlatforms Server Třída WMI definuje seznam platforem, které Configuration Manager podporuje.

TransformAnalysisDate Datový typ: DateTime

Typ přístupu: čtení/zápis

Kvalifikace: [Žádné]

Pouze pro vnitřní použití.

TransformDtID Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: [Žádné]

Pouze pro vnitřní použití.

TransformReadiness Datový typ: UInt32

Typ přístupu: čtení/zápis

Kvalifikace: [Žádné]

Pouze pro vnitřní použití.

WorkingDirectory Datový typ: String

Typ přístupu: čtení/zápis

Kvalifikace: Žádné

Umístění, ze kterého je program spuštěn. Výchozí hodnota je "".

Pracovní adresář může být absolutní cesta na klientovi nebo cesta relativní 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í kvalifikační třídy. Další informace o kvalifikátorech třídy i kvalifikátorech vlastností, které jsou součástí části Vlastnosti, najdete v tématu Configuration Manager kvalifikátory tříd a vlastností.

Program je vždy přidružen k nadřazenému balíčku 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žívá PackageID tuto vlastnost k vytvoření tohoto přidružení. Aplikace nemůže po vytvoření objektu tuto vlastnost SMS_Program změnit. Pokud chcete přidružit program k jinému balíčku, musí aplikace objekt odstranit a vytvořit nový objekt s novou PackageID hodnotou.

Když vaše aplikace odstraní SMS_Program objekt, neodstraní se, dokud se neodstraní související součásti, jako jsou jeho inzerce. Místo toho Configuration Manager nastaví ActionInProgress vlastnost na DELETE (3), aby označila program k odstranění. Pokud chcete zajistit, aby dotaz nenačítal programy, které jsou označené k odstranění, přidejte do klauzule WHERE tento případ.

Důležité

Pokud pro kolekci, ve které je program spuštěný, používáte časové intervaly údržby, může dojít ke konfliktu, pokud je hodnota Duration vlastnosti delší než naplánovaná časová doba údržby. Pokud je tato vlastnost nastavena na hodnotu Neznámá, program se spustí během časového období údržby, ale pokračuje v běhu, dokud se nedokončí nebo selže po uzavření časového intervalu údržby.

Doporučuje se nenastavovat Duration tuto vlastnost na hodnotu Neznámý, protože se používá k následujícím dvěma důležitým účelům:

• Sledování výsledků programu.

• Zjistit, zda bude program spuštěn, když byly na klientských počítačích definovány časové intervaly údržby.

  Pokud vaše aplikace nastaví Duration vlastnost, ale doba spuštění programu překročí tuto dobu trvání, pak Configuration Manager přestane program monitorovat, ale neukončí program. To umožňuje nástroji Configuration Manager pokračovat v dalších funkcích distribuce softwaru, jako je spouštění jiných inzerovaných programů. Vedoucí neprovádí:

• Zastavte program.

• Zdarma všechny jednotky, které byly namapovány pro inzerovaný program.

• Zdarma všechna síťová připojení vytvořená pro inzerovaný program.

• Bezplatné prostředky operačního systému používané nástrojem Configuration Manager, když jsou spuštěny inzerované programy.

  Další informace najdete v tématu o časových intervalech údržby.

Požadavky

Požadavky na modul runtime

Další informace najdete v tématu Požadavky na modul runtime serveru Configuration Manager.

Požadavky na vývoj

Další informace najdete v tématu Požadavky na vývoj serveru Configuration Manager.

Viz taky

Třída WMI serveru SMS_Package Jakvytvořit balíčekJak vytvořit program