Sdílet prostřednictvím


Informace o Configuration Manager klientských aplikacích vlastních akcí

Pořadí úkolů v Configuration Manager během nasazování klienta provede vlastní operace akcí. Aplikace může být proces, skript nebo jiné příkazy. Požadavky pro aplikaci jsou definovány v souboru MOF (Managed Object Format). Mezi příklady požadavků patří provozní prostředí, argumenty příkazového řádku, vlastnosti a návratové kódy. Při zpracování akce se přidají do prostředí pořadí úkolů.

Soubor MOF vlastní akce

Soubor MOF pro vlastní akci je podobný následujícímu příkladu:

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

Soubor MOF popisuje informace potřebné pro vstup aplikace vlastní akce, prostředí, vlastnosti a informace o balíčku nasazení.

Další informace najdete v tématu O souboru MOF vlastní akce Configuration Manager.

Vstup aplikace

Vlastní akce musí běžet bezobslužně, takže aplikace by neměla zobrazovat výzvu k zadání vstupu uživatele. Všechny vstupy by měly být přijaty z příkazového řádku, prostředí pořadí úkolů nebo z datového souboru.

Příkazový řádek pro aplikaci akce se nastaví v souboru MOF pomocí integrované akce Spustit příkazový řádek .

Příklady:

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

Zpracování aplikací

Aplikace pořadí úkolů spouští vlastní operace akcí. Musí vědět o svém provozním prostředí a mít přístup k proměnným prostředí pořadí úkolů, průběhu sestav a návratových kódů dokončení.

Prostředí

Soubor MOF by měl určovat provozní prostředí s vlastností SMS_TaskSequence_Action serverová třídaSupportedEnvironment služby WMI. Dostupná prostředí jsou Windows PE (WinPE), úplný operační systém (FullOS) nebo obě prostředí (WinPEandFullOS).

Volba prostředí závisí na okolnostech. Například konfigurace předběžné instalace se bude pravděpodobně provádět v prostředí prostředí Windows PE. Další informace najdete v tématu Požadavky na infrastrukturu pro nasazení operačního systému. Aktualizace k aktuálně nainstalovaným operačním systémům budou používat úplné prostředí operačního systému. Například instalace softwaru nebo ovladače. Úlohy nezávislé na prostředí operačního systému, jako jsou restartování nebo vytváření síťových připojení, je možné provádět pomocí obou nastavení prostředí.

Zpracování

Během zpracování přistupujete k proměnným pořadí úkolů definovaným souborem MOF pomocí objektu TSEnvironment automatizace MODELU COM. Další informace najdete v tématu Použití proměnných pořadí úkolů ve spuštěném Configuration Manager pořadí úkolů.

Pokud operace trvá dlouhou dobu, můžete hlásit průběh do prostředí pořadí úkolů a zobrazit indikátor průběhu pomocí třídy automatizace modelu COM klienta ProgressUI. Další informace najdete v tématu o vytváření sestav Configuration Manager průběhu vlastních akcí.

Dokončení

Po dokončení by aplikace měla nastavit SuccessCodes proměnnou prostředí jako návratovou hodnotu.

Vrátit Popis
0 Úspěch
Nenulová hodnota Selhání

Pokud se po dokončení aplikace vyžaduje restartování, SMSTSRebootRequested měla by se nastavit proměnná prostředí. Další informace najdete v tématu Proměnné pořadí úkolů. Informace o nastavení proměnných prostředí najdete v tématu Použití proměnných pořadí úkolů ve spuštěném Configuration Manager pořadí úkolů.

Nasazení

Aby ji Configuration Manager mohli používat, musí být aplikace vlastních akcí k dispozici z balíčku Configuration Manager. Správce může balíček vytvořit buď pomocí konzoly Configuration Manager, nebo pomocí programovacího jazyka. Další informace najdete v tématu Postup vytvoření balíčku.

Aby nasazení fungovalo, musí být k dispozici identifikátor balíčku. Soubor MOF obvykle deklaruje vlastnost, která ho má uchovávat, jako v následujícím příkladu:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

Poznámka

Identifikátorem balíčku je vlastnost SMS_Package serverová třídaPackageID služby WMI.

Identifikátor balíčku se získá od správce při úpravě vlastní akce v editoru pořadí úkolů.

Chcete-li toto chování povolit, může ovládací prvek vlastní akce použít ovládací prvek pro úpravy textu v jeho implementaci k získání identifikátoru balíčku od správce. Příklad, který používá textový ovládací prvek, najdete v tématu Postup vytvoření Configuration Manager vlastního ovládacího prvku akce.

Při použití správcem se vlastní ovládací prvek akce upraví jako součást pořadí úkolů pomocí editoru pořadí úkolů. Při uložení editorem pořadí úkolů se vytvoří serverová třída služby WMI SMS_TaskSequencePackage , která bude obsahovat pořadí úkolů, včetně vlastní akce.

Balíček pořadí úkolů se pak inzeruje klientům spolu s vlastním balíčkem akcí, na který odkazuje vlastní akce. Další informace najdete v tématu Vytvoření reklamy.

Při spuštění vlastní akce na klientovi se identifikátor balíčku pro vlastní akci zadá jako parametr příkazového řádku, ze kterého se extrahují a spustí binární soubory pro vlastní akci.

Identifikátor balíčku se poskytuje pomocí parametru příkazového /run řádku pro Smsswd.exe.

Předsítěžový oddíl a nastavení před oddíly

Pokud potřebujete nakonfigurovat připojení k disku nebo síti před vytvořením oddílu disku a před připojením k síti, musíte vytvořit aplikaci, která bude tyto úlohy provádět. Aplikace by měla být umístěna do vlastní spouštěcí image pomocí sady Windows Assessment and Deployment Kit (ADK). Další informace najdete v tématu Scénáře sady Windows ADK pro IT profesionály.

Poznámka

Přidání souborů do souboru spouštěcí bitové kopie může zvýšit minimální požadavky na paměť RAM a kvůli nedostatku paměti může způsobit neočekávané selhání pořadí úkolů.

Potom obrázek naimportujte do Configuration Manager jako vlastní image. Další informace najdete v tématu Přidání spouštěcí image.

Aplikace, všechny podpůrné soubory a vlastní SMSTS.INI by měly být umístěny ve složce Windows.

Pokud chcete aplikaci použít, použijte vlastní spouštěcí image v pořadí úkolů, které obsahuje krok před oddílem nebo sítí.

Viz také

Informace o Configuration Manager vlastních akcích

O souboru MOF vlastní akce Configuration Manager