Tudnivalók Configuration Manager egyéni műveleti ügyfélalkalmazásokról

Az Configuration Manager feladatütemezése egyéni műveletműveleteket hajt végre az ügyfél üzembe helyezése során. Az alkalmazás lehet folyamat, szkript vagy más parancs. Az alkalmazás követelményei egy felügyelt objektumformátumú (MOF) fájlban vannak meghatározva. A példakövetelmények közé tartozik az operációs környezet, a parancssori argumentumok, a tulajdonságok és a visszatérési kódok. A művelet feldolgozásakor a rendszer hozzáadja őket a feladatütemezési környezethez.

Egyéni művelet MOF-fájlja

Az egyéni műveletek MOF-fájlja az alábbi példához hasonló:

[   CommandLine("smsswd.exe /run:%1 abc.exe %2"),
    : (custom ui control and category qualifiers for action)
    ]
class MyCustomAction : SMS_TaskSequence_Action
{
    [TaskSequencePackage, CommandLineArg(1)]
    string          PackageIDForAbcExe;

    [CommandLineArg(2), AllowedLen("1-32000")]
    string          AbcCommandLineArgs;

    [SuccessCodes, Not_Null]
    string          AbcSuccessCodes = "0 3010";

    string         SomeOtherPropertyThatAbcNeeds;

    string          SupportedEnvironment = "WinPEandFullOS";
};

Az MOF-fájl az egyéni műveleti alkalmazás bemenetéhez, környezetéhez, tulajdonságaihoz és központi telepítési csomagjának adataihoz szükséges információkat ismerteti.

További információ: Tudnivalók az Configuration Manager egyéni művelet MOF-fájljáról.

Alkalmazásbemenet

Az egyéni műveleteknek felügyelet nélkül kell futniuk, így az alkalmazásnak nem szabad felhasználói bevitelt kérnie. Minden bemenetnek a parancssorból, a feladatütemezési környezetből vagy egy adatfájlból kell érkeznie.

A műveleti alkalmazás parancssora az MOF-fájlban a Parancssor futtatása beépített művelettel van beállítva.

Például:

CommandLine("smsswd.exe /run:PackageID abc.exe [any abc.exe command line args]"

Alkalmazásfeldolgozás

A feladatütemezési alkalmazás futtatja az egyéni műveletműveleteket. Tisztában kell lennie az üzemeltetési környezetével, és hozzá kell férnie a feladat-előkészítési környezeti változókhoz, a jelentés előrehaladásához és a visszatérési befejezési kódokhoz.

Környezet

Az MOF-fájlnak meg kell adnia az operációs környezetet a SMS_TaskSequence_Action kiszolgálói WMI-osztálySupportedEnvironment tulajdonsággal. Az elérhető környezetek a Következők: Windows PE (WinPE), teljes operációs rendszer (FullOS) vagy mindkét környezet (WinPEandFullOS).

A környezet kiválasztása a körülményektől függ. Például az operációs rendszer előtti telepítési konfiguráció valószínűleg a Windows PE környezetben lesz végrehajtva. További információ: Az operációs rendszer üzembe helyezésének infrastruktúrakövetelményei. Frissítések a jelenleg telepített operációs rendszerek a teljes operációsrendszer-környezetet használják. Például szoftver vagy illesztőprogram telepítése. Az operációs rendszer környezetétől független feladatok, például újraindítások vagy hálózati kapcsolatok létrehozása mindkét környezeti beállítással elvégezhetők.

Feldolgozás

A feldolgozás során az MOF-fájl által meghatározott feladatütemezési változókat a TSEnvironment COM automation objektum használatával érheti el. További információ: Feladatütemezési változók használata futó Configuration Manager feladatütemezésben.

Ha a művelet hosszú ideig tart, jelentést készíthet a feladatütemezési környezetnek, és megjeleníthet egy folyamatjelzőt a ProgressUI-ügyfél COM automatizálási osztályával. További információ: Az egyéni műveletek előrehaladásának jelentési Configuration Manager.

Teljesítés

Az alkalmazásnak a SuccessCodes befejezett környezeti változót visszatérési értékként kell beállítania.

Visszatérés	Leírás
0	Siker
Nem nulla	Kudarc

Ha az alkalmazás befejeződése után újraindításra van szükség, be kell állítani a SMSTSRebootRequested környezeti változót. További információ: Feladatütemezési változók. További információ a környezeti változók beállításáról: Feladatütemezési változók használata futó Configuration Manager feladatütemezésben.

Bevezetés

A Configuration Manager használatához az egyéni műveletalkalmazásnak elérhetőnek kell lennie egy Configuration Manager csomagból. A rendszergazda a csomagot az Configuration Manager-konzolon vagy egy programozási nyelv használatával hozhatja létre. További információ: Csomag létrehozása.

A csomagazonosítónak elérhetőnek kell lennie ahhoz, hogy az üzembe helyezés működjön. Az MOF-fájl általában egy tulajdonságot deklarál, amely azt tartalmazza, ahogy az alábbi példában látható:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

Megjegyzés:

A csomagazonosító a SMS_Package kiszolgálói WMI-osztályPackageID tulajdonság.

A csomagazonosítót a rendszer a rendszergazdától szerzi be, amikor az egyéni műveletet szerkessze a feladatütemezési szerkesztőben.

Ennek a viselkedésnek az engedélyezéséhez az egyéni műveletvezérlő szöveges szerkesztési vezérlőt használhat annak implementációjában a csomagazonosító rendszergazda általi lekéréséhez. Szövegvezérlőt használó példa: Configuration Manager egyéni műveletvezérlő létrehozása.

Ha a rendszergazda használja, az egyéni műveletvezérlő a feladatütemezés részeként lesz szerkeszthető a feladatütemezés-szerkesztővel. Amikor a feladatütemezési szerkesztő menti, a rendszer létrehoz egy SMS_TaskSequencePackage kiszolgálói WMI-osztályt a feladatütemezés tárolásához, beleértve az egyéni műveletet is.

A feladatütemezési csomag ezután az ügyfelek számára lesz meghirdetve az egyéni művelet által hivatkozott egyéni műveletcsomaggal együtt. További információ: Hirdetés létrehozása.

Ha az egyéni műveletet az ügyfélen futtatja, az egyéni művelet csomagazonosítója parancssori paraméterként lesz megadva, amelyből kinyeri és futtatja az egyéni művelet bináris fájljait.

A csomagazonosítót a /run parancssori paraméterrel Smsswd.exe.

Hálózat előtti partíció és előpartíció beállítása

Ha a lemezpartíció létrehozása előtt és a hálózati kapcsolat előtt konfigurálnia kell a lemezt vagy a hálózati kapcsolatot, létre kell hoznia egy alkalmazást ezekhez a feladatokhoz. Az alkalmazást egy egyéni rendszerindító lemezképbe kell helyezni a Windows Assessment and Deployment Kit (ADK) használatával. További információ: Windows ADK-forgatókönyvek informatikai szakemberek számára.

Megjegyzés:

Ha fájlokat ad hozzá a rendszerindító lemezképfájlhoz, azzal növelheti a ram minimális követelményeit, és a kevés memória miatt a feladatütemezések váratlanul meghiúsulhatnak.

Ezután importálja a képet Configuration Manager egyéni rendszerképként. További információ: Rendszerindító lemezkép hozzáadása.

Az alkalmazást, a támogató fájlokat és az egyéni SMSTS.INI a Windows mappába kell helyezni.

Az alkalmazás használatához használja az egyéni rendszerindító lemezképet egy olyan feladatütemezésben, amely egy előpartíciós/hálózati lépést tartalmaz.

Lásd még

Az egyéni műveletek Configuration Manager

Az Configuration Manager egyéni művelet MOF-fájljának ismertetése