SMS_Program kiszolgálói WMI-osztály

Cikk
2023-04-04

A SMS_Program Windows Management Instrumentation (WMI) osztály egy SMS Provider kiszolgálóosztály Configuration Manager, amely egy olyan programot vagy parancsot jelöl, amelyet a szoftver ügyfélszámítógépre történő terjesztésekor kell futtatni.

Az alábbi szintaxis egyszerűbb a Felügyelt objektumformátum (MOF) kódból, és az összes örökölt tulajdonságot tartalmazza.

Szintaxis

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;  
};

Módszerek

A SMS_Program osztály nem definiál metódusokat.

Tulajdonságok

ActionInProgress
Adattípus: UInt32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás, számbavétel]

Az aktuális művelet a programhoz társított csomagon Configuration Manager. A lehetséges értékek a következők:

Érték	Leírás
0	NINCS
1	FRISSÍTÉS
2	HOZZÁADÁSA
3	TÖRÖL

Ezzel a tulajdonsággal a WHERE záradékban kiszűrhetők azok a programok, amelyek törlésre lettek megjelölve, de még nem lettek törölve. További információt a témakör későbbi, Megjegyzések szakaszában talál.

ApplicationHierarchy
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A program alkalmazáshierarchiája. Az alapértelmezett érték a "".

CommandLine
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A program indításakor futó parancssor. Az alapértelmezett érték a "".

Comment
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A programot a Configuration Manager-konzolon leíró megjegyzés. Az alapértelmezett érték a "".

DependentProgram
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

Formázott szöveges sztring, amely a program futtatása előtt futtatandó programokat definiálja. A formátum packageID<>;;<ProgramName>. Ha a program ugyanabban a csomagban található, a hívó alkalmazás egyszerűen megadhatja a ;;<ProgramName>. Az alapértelmezett érték a "".

A függőség csak a program első futtatásakor marad fenn. A program futtatása után a program figyelmen kívül hagyja a függőséget. Nem hozhat létre például ismétlődő ütemezett feladatot, amelynek függőségét minden program futtatásakor fenntartja a rendszer.

Description
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

Nincs használatban.

DeviceFlags
Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A programhoz társított eszközt leíró jelzők. A lehetséges értékek a következők:

Hexadecimális (bit)	Leírás
0x01000000 (24)	Mindig rendeljen programot az ügyfélhez.
0x02000000 (25)	Csak akkor rendelje hozzá, ha az eszköz jelenleg nagy sávszélességű kapcsolathoz csatlakozik (alapértelmezés szerint 60 KBps fölött).
0x04000000 (26)	Csak akkor rendelje hozzá, ha az eszköz rögzítve van, azaz egy ActiveSyncet használó asztalhoz van csatolva.

DiskSpaceReq
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A program által igényelt hozzávetőleges lemezterület. A formátum a következő: "<kb. méret><|MB|GB>". Az alapértelmezett érték a "".

Ezek az információk a Configuration Manager konzolon és a hirdetésben használhatók a program lemezterület-követelményeire vonatkozó riasztások biztosítására. A felhasználó ezután dönthet úgy, hogy elfogadja a hirdetést, vagy először lemezkezelési feladatot hajt végre.

DriveLetter
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: [SizeLimit("1"), Range("a-z")]

Meghajtó betűjele (az a-z tartományban egy karakter), amelybe a program leképezési és futtatási elemet használ. Az alapértelmezett érték a "".

Duration
Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A program végrehajtásának hozzávetőleges időtartama percekben az ügyfélszámítógépen. Adja meg ezt az értéket 0-nál nagyobb vagy egyenlő egész számként (alapértelmezés szerint) vagy Ismeretlenként (nem ajánlott). Ha a tulajdonság Értéke Ismeretlen, Configuration Manager a maximálisan engedélyezett futási időt 720 percre (12 órára) állítja. További információt a témakör későbbi, Megjegyzések szakaszában talál.

Megjegyzés:

Az ügyfélszámítógépeken a közzétett programok megadott értéke megjelenik a Run Advertised Programs Vezérlőpult.

ExtendedData
Adattípus: UInt8 Tömb

Hozzáférés típusa: Olvasás/írás

Minősítők: [nagy, lusta]

A rendszerképek üzembe helyezéséhez használható XML-blob.

ExtendedDataSize
Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: [lusta]

A kiterjesztett adatméret bájtban kifejezve. Az alapértelmezett érték 0.

Icon
Adattípus: UInt8 Tömb

Hozzáférés típusa: Olvasás/írás

Minősítők: [nagy]

A programikonnal társított ikonadatok a Configuration Manager konzolon láthatók.

IconSize
Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: [lusta]

A program ikonjának mérete bájtban. Állítsa ezt a tulajdonságot 0 értékre az ikon törléséhez.

ISVData
Adattípus: UInt8 Tömb

Hozzáférés típusa: Olvasás/írás

Minősítők: [nagy, lusta]

Olyan információk, amelyek lehetővé teszik, hogy egyetlen független szoftverszállító tároljon egy SMS_Program objektummal kapcsolatos adatokat.

Az ISV-adatokra nincsenek korlátozások vagy meghatározott formátumok. Fontos azonban, hogy az ISV tulajdonjogának létrehozása után ne írja felül a tulajdonságot. Az alkalmazásnak először be kell olvasnia a tulajdonságban meglévő adatokat. Ha az adatok nem tartoznak az alkalmazáshoz, nem szabad módosítani. A program adataiban szerepelnie kell egy azonosítónak, hogy a tulajdonjog könnyen megállapítható legyen.

ISVDataSize
Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: [lusta]

A fájlban tárolt adatok mérete bájtban ISVData. Az alapértelmezett érték 0.

ISVString
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: nincs

A partner bővíthetőségének sztringje.

MSIFilePath
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

Annak a Windows Installer-csomagnak a fájlelérési útja, amelyhez a program társítva van. Az alapértelmezett érték a "".

MSIProductID
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

Annak a Windows Installer-csomagnak a termékazonosítója, amelyhez a program társítva van. Az alapértelmezett érték a "".

PackageID
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: [kulcs, Not_null]

Annak a meglévő csomagnak az azonosítója, amelyhez társítani szeretné a programot. További információt a témakör későbbi, Megjegyzések szakaszában talál.

PackageName
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: [Nincs]

Annak a csomagnak a neve, amelyhez a program tartozik.

PackageType
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: [Nincs]

Annak a csomagnak a típusa, amelyhez a program tartozik.

Érték	Leírás
0	Normál szoftverterjesztési csomag.
3	Illesztőprogram-csomag.
4	Feladatütemezési csomag.
5	Szoftverfrissítési csomag.
6	Eszközbeállítási csomag.
257	Képcsomag.
258	Rendszerindító lemezképcsomag.
259	Operációs rendszer telepítőcsomagja.

PackageVersion
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: [Nincs]

Annak a csomagnak a verziója, amelyhez a program tartozik.

ProgramFlags
Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: [bitek]

A program telepítési jellemzőit azonosító jelzők. A lehetséges értékek az alábbiakban láthatók. Az alapértelmezett értékek: EVERYUSER, USEUNCPATH, USERCONTEXT és UNATTENDED.

Megjegyzés:

Programozott használat SMS_Program esetén győződjön meg arról, hogy nincsenek-e kiválasztva ütköző értékek. A NOUSERLOGGEDIN és a USERCONTEXT például nem használható együtt.

A lehetséges értékek a következők:

Hexadecimális (bit)	Leírás
0x00000001 (0)	AUTHORIZED_DYNAMIC_INSTALL. A program jogosult a dinamikus telepítésre.
0x00000002 (1)	USECUSTOMPROGRESSMSG. A feladatütemezés egy egyéni folyamatjelző felhasználói felületi üzenetet jelenít meg.
0x00000010 (4)	DEFAULT_PROGRAM. Ez egy alapértelmezett program
0x00000020 (5)	DISABLEMOMALERTONRUNNING. Letiltja a MOM-riasztásokat a program futása közben.
0x00000040 (6)	MOMALERTONFAIL. MOM-riasztást hoz létre, ha a program meghiúsul.
0x00000080 (7)	RUN_DEPENDANT_ALWAYS. Ha be van állítva, a program azonnali függőségét mindig futtatni kell.
0x00000100 (8)	WINDOWS_CE. Eszközprogramot jelez. Ha be van állítva, a program nem érhető el az asztali ügyfelek számára.
0x00000200 (9)	Ez az érték nem használatos.
0x00000400 (10)	VISSZASZÁMLÁLÁS. A visszaszámlálás párbeszédpanel nem jelenik meg.
0x00000800 (11)	FORCERERUN. Ez az érték nem használatos.
0x00001000 (12)	TILTVA. A program le van tiltva.
0x00002000 (13)	FELÜGYELET NÉLKÜL. A program nem igényel felhasználói beavatkozást.
0x00004000 (14)	USERCONTEXT. A program csak akkor futhat, ha egy felhasználó be van jelentkezve.
0x00008000 (15)	ADMINRIGHTS. A programot helyi rendszergazdai fiókként kell futtatni.
0x00010000 (16)	MINDENFELHASZNÁLÓ. A programot minden olyan felhasználónak futtatnia kell, akinek érvényes. Csak kötelező feladatokhoz érvényes.
0x00020000 (17)	NOUSERLOGGEDIN. A program csak akkor fut, ha nincs bejelentkezett felhasználó.
0x00040000 (18)	OKTOQUIT. A program újraindítja a számítógépet.
0x00080000 (19)	OKTOREBOOT. Configuration Manager újraindítja a számítógépet, ha a program sikeresen lefutott.
0x00100000 (20)	USEUNCPATH. A terjesztési pont eléréséhez használjon UNC elérési utat (meghajtóbetűjel nélkül).
0x00200000 (21)	PERSISTCONNECTION. Megőrzi a kapcsolatot a DriveLetter tulajdonságban megadott meghajtóval. A USEUNCPATH bitjelölőt nem szabad beállítani.
0x00400000 (22)	RUNMINIMIZED. Futtassa a programot kis méretű ablakként.
0x00800000 (23)	RUNMAXIMIZED. Futtassa a programot teljes méretű ablakként.
x01000000 (24)	HIDEWINDOW. A program ablakának elrejtése.
0x02000000 (25)	OKTOLOGOFF. Kijelentkezés a program sikeres befejeződésekor.
0x04000000 (26)	RUNACCOUNT. Ez az érték nem használatos.
0x08000000 (27)	ANY_PLATFORM. Platformtámogatás felülbírálása.
0x10000000 (28)	STILL_RUNNING. Ez az érték nem használatos.
0x20000000 (29)	SUPPORT_UNINSTALL. Futtassa az eltávolítást a beállításkulcsból, amikor a hirdetés lejár.
0x40000000 (30)	A platform nem támogatott.
0x80000000 (31)	SHOW_IN_ARP. Ez az érték nem használatos.

ProgramName
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: [kulcs, Not_null]

A programot jelölő egyedi név.

RemovalKey
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A program eltávolítási parancsfájlját azonosító beállításkulcs. A szkriptnek a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall beállításjegyzék elérési útján kell lennie. Az alapértelmezett érték a "".

Requirements
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A program további követelményeinek leírása. Az alapértelmezett érték a "".

SecuredTypeID
Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: [Nincs]

A kapcsolódó csomag biztonságos típusa.

SupportedOperatingSystems
Adattípus: SMS_OS_Details Tömb

Hozzáférés típusa: Olvasás/írás

Minősítők: [lusta]

SMS_OS_Details kiszolgálói WMI-osztály objektumai, amelyek azokat az operációs rendszereket jelölik, amelyeken a program futhat.

Ha nem adja meg ANY_PLATFORM a ProgramFlags tulajdonságban, meg kell adnia egy vagy több támogatott operációs rendszert. SMS_SupportedPlatforms kiszolgálói WMI-osztály határozza meg a Configuration Manager által támogatott platformok listáját.

TransformAnalysisDate
Adattípus: DateTime

Hozzáférés típusa: Olvasás/írás

Minősítők: [Nincs]

Csak belső használatra.

TransformDtID
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: [Nincs]

Csak belső használatra.

TransformReadiness
Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: [Nincs]

Csak belső használatra.

WorkingDirectory
Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

Az a hely, ahonnan a program fut. Az alapértelmezett érték a "".

A munkakönyvtár lehet abszolút elérési út az ügyfélen, vagy egy elérési út a csomagot tartalmazó terjesztésipont-mappához képest. Ha nincs megadva munkakönyvtár, Configuration Manager az alapértelmezett terjesztésipont-mappát használja.

Megjegyzések

Ehhez az osztályhoz nincsenek speciális osztályminősítők. A Tulajdonságok szakaszban szereplő osztályminősítőkkel és tulajdonságminősítőkkel kapcsolatos további információkért lásd: Configuration Manager Osztály- és tulajdonságminősítők.

A program mindig egy szülőcsomaghoz van társítva, és általában a csomag telepítőprogramját jelöli. Több program is társítható ugyanahhoz a csomaghoz. Az alkalmazás a PackageID tulajdonságot használja a társítás létrehozásához. Az alkalmazás nem tudja módosítani ezt a tulajdonságot az SMS_Program objektum létrehozása után. Ha a programot egy másik csomaggal szeretné társítani, az alkalmazásnak törölnie kell az objektumot, és létre kell hoznia egy új objektumot egy új PackageID értékkel.

Amikor az alkalmazás töröl egy SMS_Program objektumot, addig nem törlődik, amíg a kapcsolódó összetevők, például a hirdetései nem törlődnek. Ehelyett Configuration Manager a ActionInProgress tulajdonságot DELETE (3) értékre állítja, hogy megjelölje a programot törlésre. Annak érdekében, hogy egy lekérdezés ne kérje le a törlésre megjelölt programokat, adja hozzá ezt az esetet a WHERE záradékhoz.

Fontos

Ha karbantartási időszakokat használ ahhoz a gyűjteményhez, amelyen a programot futtatja, ütközés léphet fel, ha a Duration tulajdonság értéke hosszabb, mint az ütemezett karbantartási időszak. Ha ez a tulajdonság Ismeretlen értékre van állítva, a program a karbantartási időszak alatt indul el, de addig fut, amíg be nem fejeződik, vagy a karbantartási időszak bezárása után meghiúsul.

Javasoljuk, hogy ne állítsa a Duration tulajdonságot Ismeretlen értékre, mert ez a tulajdonság a következő két fontos célra használható:

A program eredményeinek figyelése.
Annak meghatározása, hogy a program elindul-e, amikor karbantartási időszakokat határoznak meg az ügyfélszámítógépeken.

Ha az alkalmazás beállítja a tulajdonságot, de a Duration program futási ideje meghaladja ezt az időtartamot, akkor Configuration Manager leállítja a program figyelését, de nem állítja le a programot. Ez lehetővé teszi, hogy Configuration Manager folytassa más szoftverterjesztési funkciókkal, például más meghirdetett programok futtatásával. A vezető nem:
Állítsa le a programot.
Szabadíts fel minden olyan meghajtót, amely le van képezve a meghirdetett programhoz.
Szabadíts fel minden hálózati kapcsolatot, amely a meghirdetett programhoz készült.
A meghirdetett programok futtatásakor a Configuration Manager által használt ingyenes operációsrendszer-erőforrások.

További információ: Tudnivalók a karbantartási időszakokról.