Průvodce aktivitou příkazového řádku

Článek
07/10/2024

Průvodce aktivitou příkazového řádku umožňuje rychle vytvářet nové aktivity v nástroji Orchestrator zapouzdřením příkazů, argumentů a parametrů do sestavení Microsoft .NET (.DLL). Průvodce automaticky vytvoří zdrojový kód jazyka C# pomocí sady Orchestrator SDK a zkompiluje ho za vás. Pomocí tohoto sestavení můžete pomocí integračního balíčku .NET (součást integrační sady nástrojů) otestovat své aktivity a pak pomocí Průvodce integračním balíčkem zabalit sestavení do vlastního integračního balíčku, který lze distribuovat a nasazovat stejně jako ostatní integrační balíčky.

Sestavení může obsahovat jednu nebo více aktivit (příkazů) a aktivity můžou být jedním nebo více dostupnými typy příkazů (příkazový řádek, příkazový řádek, PowerShell nebo příkaz SSH). Definujete název aktivity, strukturu příkazů, vstupní parametry a dokonce i publikovaná data (výstup).

Přehled aktivit v Orchestratoru

Aktivita je jednou funkční součástí runbooku Orchestrator. Aktivity jsou to, co dělají skutečnou práci v runboocích a spojují se pomocí odkazů, které je možné definovat pomocí podmínek pro vytvoření větví pracovního postupu. Při vytváření runbooku pomocí nástroje Runbook Designer přetáhnete aktivity z podokna Aktivity do runbooku a propojíte je dohromady a vytvoříte pracovní postup. Při spuštění runbooku vyvolá každou aktivitu v sekvenci podle toho, jak byly propojené. Každá aktivita provádí určitou povinnost a může shromažďovat vstupní data z datové sběrnice Orchestratoru a publikovat výstup do stejné datové sběrnice. Každá aktivita má možnost nakreslit publikovaná data z jakékoli aktivity, která byla spuštěna před ní v runbooku, a publikování výstupních dat umožňuje následující aktivity přístup k této aktivitě.

Aktivity se liší od jednoduchých až po složité. Aktivitu můžete vytvořit pomocí Průvodce aktivitou příkazového řádku, který neprovádí nic, ale opakuje text výstupní vlastnosti. Můžete také vytvořit jednu aktivitu, která provádí složitou akci s více kroky, jako je nasazení virtuálního počítače. Je na vás, abyste definovali, co jednotlivé aktivity budou dělat. Vaším cílem by však mělo být definovat aktivity, které zapouzdřují jednotlivé sady funkcí, které umožňují snadné opakované použití v mnoha různých typech situací. Klíčem je flexibilita. Je lepší vytvořit sadu 10 různých aktivit, které každý dělá něco specifického a může tyto aktivity používat 20 různými způsoby, a ne vytvořit 20 různých aktivit pro řešení konkrétních jednotlivých scénářů. Další informace o osvědčených postupech najdete dále v tomto dokumentu.

Vytvoření nového sestavení aktivity

Vytvoření nového sestavení aktivity příkazového řádku

Chcete-li vytvořit nové sestavení aktivity příkazového řádku, postupujte takto:

Vyberte Spustit > všechny programy > Microsoft System Center 2012 > Orchestrator Integration Toolkit > Orchestrator > Průvodce aktivitou příkazového řádku nástroje Orchestrator
Vyberte Další.
Na stránce Podrobnosti sestavení zadejte hodnotu pro Název, která začíná písmenem a následuje nula nebo více alfanumerických znaků. Tento název se používá jako identifikátor oboru názvů jazyka C# pro sestavení a vaše aktivity.
V souboru sestavení zadejte cestu a název souboru sestavení, který bude vytvořen tímto průvodcem. Pokud tento soubor již existuje, zobrazí se výzva k přepsání souboru.

Vyberte informace o sestavení. Zde můžete zadat informace, které se stanou vlastnostmi souboru sestavení, viditelné v Průzkumníku Windows prostřednictvím vlastností souboru. Hodnoty vlastností jsou definovány v tabulce níže. Tyto informace jsou volitelné a nejsou nutné k sestavení sestavení.

Vlastnost	Popis
Název	Určuje název sestavení, který se zobrazí jako vlastnost Popis souboru ve vlastnostech Průzkumníka Windows.
Popis	Určuje volitelný popis sestavení, který se nezobrazuje ve vlastnostech Průzkumníka Windows.
Produkt	Určuje název produktu pro sestavení, který se zobrazí jako vlastnost Název produktu ve vlastnostech Průzkumníka Windows.
Společnost	Určuje název společnosti pro sestavení, který se nezobrazuje ve vlastnostech Průzkumníka Windows.
Autorské právo	Určuje oznámení o autorských právech pro sestavení, které se zobrazí jako Autorská práva ve vlastnostech Průzkumníka Windows.
Ochranná známka	Určuje ochrannou známku pro sestavení, která se ve vlastnostech Průzkumníka Windows zobrazuje jako právní ochranné známky.
Verze	Určuje verzi sestavení a verzi souboru. Ty se zobrazí ve vlastnostech Průzkumníka Windows jako verze souboru a verze produktu. Číslo verze má čtyři části následujícím způsobem: <hlavní verze>.<podverze>.<číslo buildu>.<revize>

Po zadání informací o sestavení vyberte OK .
Vyberte Další. Zobrazí se stránka Příkazy .
Přidejte jeden nebo více příkazů podle pokynů uvedených v části Přidat příkazy do sestavení.
Po dokončení definice aktivity vyberte OK. Dialogové okno se zavře a nová aktivita se přidá do seznamu na stránce Příkazy . Pokud se potřebujete vrátit zpět a upravit příkaz, vyberte příkaz v seznamu a vyberte Upravit. Pokud potřebujete příkaz odstranit, vyberte ho v seznamu a vyberte Odebrat.
Až přidávání a úpravy příkazů dokončíte, vyberte Další. Soubor sestavení zadaný na začátku průvodce je zkompilován a po dokončení procesu se zobrazí poslední stránka průvodce.
Pokud chcete z tohoto nového sestavení okamžitě sestavit integrační balíček, vyberte tlačítko Sestavit integrační balíček , které spustí Průvodce integračním balíčkem integrace a předem načte informace ze sestavení. Potom postupujte podle pokynů v části Vytvoření nového integračního balíčku a vytvořte integrační balíček.
Pokud chcete otestovat sestavení pomocí aktivity Invoke .NET nebo prostě přeskočit proces sestavení PROTOKOLU IP prozatím, vyberte Dokončit.

Přidání příkazů do sestavení

Přidání příkazu do sestavení

Chcete-li přidat příkaz do sestavení, postupujte takto:

Na stránce Příkazy můžete definovat jeden nebo více příkazů (které se stanou aktivitami), které se přidají do sestavení. Pokud chcete přidat nový příkaz, vyberte Přidat.
Zobrazí se dialogové okno Přidat/upravit příkaz a obsahuje tři karty: Obecné, Argumenty a Publikovaná data. Zadejte Název příkazu. Toto se stane názvem zobrazeným v nástroji Runbook Designer pro aktivitu. Volitelně můžete také zadat popis příkazu.
Selektor vlastností Režim obsahuje čtyři možnosti: Spustit příkaz, Spustit Windows PowerShell, Spustit program a Spustit příkaz SSH. Pokud jste vybrali režim Spustit program , pole Program se aktivuje. Vyberte tlačítko se třemi tečkou (...) a vyhledejte program, který chcete spustit.

Poznámka:

Program vybraný v příkazu Spustit program bude vyvolán na serveru sady Runbook, kde se runbook obsahující tuto aktivitu spouští. Tento program proto musí existovat na všech serverech runbooků, ve kterých očekáváte, že runbook spustíte.
Vyberte kartu Argumenty.
Do pole Příkazového řádku zadejte parametry příkazového řádku nebo příkazového řádku, které vaše aktivita potřebuje. Pokud příkaz vezme parametry, které mají uživatelé zadat, budete je muset přidat do seznamu parametrů níže a pak je pomocí tlačítka Vložit přidat do příkazového řádku.

Důležité

Pokud jste zadali prostředí Windows PowerShell pro režim a odkazujete na skript PowerShellu, který je součástí integračního balíčku, musíte před název skriptu zadat tečky a znaky lomítka, aby odkazy na místní adresář. Například .\MyScript.ps1 by byl zadán pro skript s názvem MyScript.ps1. Důvodem je to, že soubor skriptu se zkopíruje do výchozího adresáře integračního balíčku. Když Windows PowerShell spustí skript z místního adresáře, musí tuto notaci zadat.
Pokud chcete zadat parametry pro příkazový řádek, vyberte Přidat. Zobrazí se dialogové okno Přidat nebo upravit parametr .
Do pole Název zadejte název parametru, který přidáváte. Toto je zobrazovaný název parametru zobrazeného v seznamu Vlastnosti aktivity.

V rozevíracím seznamu Režim použití vyberte režim, který použijete pro parametr. Režim použití má dvě možnosti:

Režim použití Popis

Argument příkazu Tuto možnost vyberte, pokud chcete tento argument použít jako parametr v příkazovém řádku (pomocí tlačítka Vložit ). Například parametr argumentu příkazu s názvem Složka může být umístěn na příkazovém řádku takto:

Dir $(folder)Poznámka: Pokud argumenty příkazového řádku obsahují mezery (například názvy složek), budete je možná muset uzavřít do uvozovek, aby příkaz fungoval správně. Příklad: Dir "$(folder)"

Proměnná prostředí Tuto možnost vyberte, pokud chcete tento argument použít jako proměnnou prostředí, která se nastaví před spuštěním příkazového řádku. Dá se použít jako parametr příkazového řádku nebo jako proměnná prostředí ve skriptu, který se spouští.

Například parametr proměnné prostředí s názvem "Folder" se dá umístit do příkazového řádku takto:

Dir %Folder%Důležitý: Název proměnné prostředí již existuje v uživatelských nebo systémových prostředích; příkaz selže s chybovou zprávou podobnou následující: Položka již byla přidána. Key in dictionary: 'folder' Key being added: 'folder'. To, které proměnné prostředí existují v místním nebo vzdáleném počítači, můžete určit tak, že vyberete Spustit > spuštění a zadáte MSINFO32.EXE. Pak vyberte Proměnné prostředí softwarového prostředí>. Pokud chcete vybrat jiný počítač, stiskněte <ctrl+R>, vyberte vzdálený počítač v síti, zadejte název počítače a vyberte OK.

Režim použití	Popis
Argument příkazu	Tuto možnost vyberte, pokud chcete tento argument použít jako parametr v příkazovém řádku (pomocí tlačítka Vložit ). Například parametr argumentu příkazu s názvem Složka může být umístěn na příkazovém řádku takto: `Dir $(folder)`Poznámka: Pokud argumenty příkazového řádku obsahují mezery (například názvy složek), budete je možná muset uzavřít do uvozovek, aby příkaz fungoval správně. Příklad: `Dir "$(folder)"`
Proměnná prostředí	Tuto možnost vyberte, pokud chcete tento argument použít jako proměnnou prostředí, která se nastaví před spuštěním příkazového řádku. Dá se použít jako parametr příkazového řádku nebo jako proměnná prostředí ve skriptu, který se spouští. Například parametr proměnné prostředí s názvem "Folder" se dá umístit do příkazového řádku takto: `Dir %Folder%`Důležitý: Název proměnné prostředí již existuje v uživatelských nebo systémových prostředích; příkaz selže s chybovou zprávou podobnou následující: Položka již byla přidána. Key in dictionary: 'folder' Key being added: 'folder'. To, které proměnné prostředí existují v místním nebo vzdáleném počítači, můžete určit tak, že vyberete Spustit > spuštění a zadáte `MSINFO32.EXE`. Pak vyberte Proměnné prostředí softwarového prostředí>. Pokud chcete vybrat jiný počítač, stiskněte <ctrl+R>, vyberte vzdálený počítač v síti, zadejte název počítače a vyberte OK.

V rozevíracím seznamu Styl zobrazení vyberte styl, který použijete k zobrazení parametru. Styl zobrazení určuje, jak bude uživatel pracovat se vstupem, když se mu zobrazí. Možnosti jsou popsané níže:

Styl zobrazení	Popis
Text	Uživateli se zobrazí textové pole volného formuláře pro zadání hodnoty.
Šifrovaný text	Uživateli se zobrazí maskované textové pole. Data v tomto poli budou zašifrována v databázi a nebudou se zobrazovat v žádných protokolech.
True/false	Uživatel může v automaticky otevírané dialogovém okně vybrat True nebo False.
Text s výběrem	Uživatel může vybrat ze skupiny možností , které zadáte.
Datum a čas	Uživatel může vybrat hodnotu pomocí ovládacího prvku Výběr data a času.
Soubor	Uživatel může vybrat hodnotu pomocí ovládacího prvku Prohlížeč souborů.
Složka	Uživatel může vybrat hodnotu pomocí ovládacího prvku Prohlížeč složek.
Počítač	Uživatel může vybrat hodnotu pomocí ovládacího prvku Prohlížeč počítače.

Pokud parametr vyžaduje nebo chcete zadat výchozí hodnotu, zadejte ho do pole Výchozí hodnota .
Pokud jste vybrali možnost Text s výběrem, je pole Možnosti povolené. Pokud chcete přidat hodnoty možností, ze které může uživatel vybírat, vyberte tlačítko se třemi tečkou vedle pole Možnosti a zadejte je. Každá možnost je uvedená na samostatném řádku. Po dokončení přidávání možností vyberte OK.
Až definici parametru dokončíte, vyberte OK.
Pokud je parametr definovaný jako parametr command, můžete ho teď přidat do příkazového řádku tak, že umístíte kurzor na požadovaný kurzor do příkazového řádku a pak vyberete tlačítko Vložit a vyberete název parametru. Pokud je proměnná prostředí definovaná jako proměnná prostředí, musíte ji zadat ručně (ve formátu %variable%), pokud ji chcete zadat do příkazového řádku.
Pokud jste zvolili režimy Spustit program nebo Spustit příkazový řádek , je povoleno zaškrtávací políčko Zahrnout parametr pracovního adresáře.
Vyberte kartu Publikovaná data. Nastavení na této kartě umožňují publikovat výstupní data do datové sběrnice nástroje Orchestrator, aby tyto informace mohly používat jiné aktivity.
Pokud chcete přidat novou publikovanou datovou vlastnost, vyberte Přidat.

Pokud jste vybrali možnost Spustit příkaz, Spustit program nebo Spustit příkaz SSH z rozevíracího seznamu Režim na kartě Obecné v dialogovém okně Přidat nebo upravit příkaz, zobrazí se v dialogovém okně Přidat nebo upravit publikovaná data následující položky:

Items	Popis
Name	Zobrazovaný název položky publikovaných dat, kterou vytváříte
Zdroj	Zdroj položky publikovaných dat. Z příkazového řádku si můžete vybrat ze standardního výstupního datového proudu nebo standardního chybového streamu .
Režim	Režim, který chcete použít k výběru publikovaných dat. Pomocí vzoru shody určete, jestli se daný vzor nachází ve zdroji. Tím se vrátí hodnota True nebo False. Použití extrahování skupiny k načtení každé položky dat, která odpovídají zadanému vzoru
Vzor	Regulární výraz, který se vztahuje na nastavení Režim
Popis	Text popisu, který se zobrazí vedle vlastnosti publikovaných dat v nástroji Runbook Designer. (volitelné)

Pokud jste vybrali možnost Spustit prostředí Windows PowerShell z rozevíracího seznamu Režim na kartě Obecné v dialogovém okně Přidat nebo upravit příkaz, zobrazí se v dialogovém okně Přidat nebo upravit publikovaná data následující položky:

Items	Popis
Name	Zobrazovaný název položky publikovaných dat, kterou vytváříte
Vlastnost	Název vlastnosti Windows PowerShellu, která se uloží do položky publikovaných dat. Tato vlastnost musí být obsažena ve výstupu objektu do kanálu PowerShellu během skriptu a nesmí být objektem (mělo by být možné převést na řetězec).
Popis	Text popisu, který se zobrazí vedle vlastnosti publikovaných dat v nástroji Runbook Designer. (volitelné)

Kliknutím na tlačítko OK dokončíte přidání položky publikovaných dat. Opakujte kroky 16 až 18 pro každou položku publikovaných dat, kterou chcete přidat.
Výběrem ok zavřete dialogové okno Přidat nebo upravit příkaz a vraťte se do dialogového okna Příkazy.

Testování sestavení aktivity

Po vytvoření sestavení ho můžete otestovat pomocí aktivity Invoke .NET (obsažená v IP adrese integrační sady nástrojů pro .NET) a ověřit, jestli funguje podle očekávání, než ho převedete na vlastní integrační balíček.

Otestování sestavení

K otestování sestavení postupujte takto:

Otevřete Runbook Designer.
Vytvořte nový runbook.
V podokně Aktivity vyberte kategorii Integrační sada nástrojů a rozbalte ji a přetáhněte aktivitu Invoke .NET do nového runbooku.
Poklikáním na objekt Vyvolat .NET zobrazte dialogové okno Vlastnosti .
V poli Sestavení vyhledejte soubor sestavení, který jste vytvořili pomocí Průvodce aktivitou příkazového řádku (nebo prostřednictvím vlastního vývoje pomocí sady SDK) výběrem tlačítka se třemi tečky (...) napravo od pole. Vyberte soubor a vyberte Otevřít.
Výběrem tlačítka se třemi tečky napravo od pole Třída zobrazíte seznam jednotlivých příkazů v sestavení. Vyberte třídu příkazů a vyberte OK. Parametry pro tuto třídu se zobrazí na kartě Vlastnosti dialogového okna.
Pole Nastavení se používá pouze vlastními vyvinutými třídami pomocí sady Orchestrator SDK s atributem OrchestratorData. Další informace o sadě SDK naleznete v tématu System Center Orchestrator Integration Toolkit SDK.
Vyberte na kartě Vlastnosti.
Podle potřeby zadejte informace o jednotlivých vlastnostech.
Výběrem možnosti Dokončit uložte nastavení a vraťte se do runbooku.
Na panelu nástrojů v nástroji Runbook Designer vyberte Runbook Tester . Spustí se runbook Tester.
Na panelu nástrojů vyberte Spustit do zarážky . Runbook se spustí a vaše aktivita se spustí. Výsledky aktivity se zobrazují v podokně Spustit protokol .
Výběrem možnosti Zobrazit podrobnosti pod názvem aktivity v podokně Spustit protokol zobrazíte podrobné výsledky, včetně vstupních vlastností a publikovaných dat.

Migrace aktivit rozhraní příkazového řádku QIK

Pokud máte sestavení vytvořené pomocí Průvodce rozhraním příkazového řádku QIK Opalis 6.3, budete ho muset převést tak, aby byl kompatibilní s orchestrátorem, než ho budete moct použít v integračním balíčku orchestratoru nebo použít přímo v runbookech prostřednictvím aktivity Invoke .NET. Proces převodu je jednoduchý a trvá jen několik sekund na sestavení.

Důležité

Instalace sady Nástrojů Orchestrator Integration Toolkit se nezdaří, pokud není nainstalovaná sada Microsoft .NET Framework 3.5, Service Pack 1, ale pokud není k dispozici, jiné operace v Průvodci aktivitou příkazového řádku selžou. Před použitím rozhraní příkazového řádku se ujistěte, že je nainstalovaná sada Microsoft .NET Framework 3.5, Service Pack 1.

Převod sestavení ROZHRANÍ příkazového řádku OPalis QIK

Pokud chcete převést sestavení ROZHRANÍ příkazového řádku Opalis QIK, postupujte takto:

Spusťte Průvodce aktivitou příkazového řádku nástroje Orchestrator výběrem průvodce spuštěním > všech programů > v nástroji Microsoft System Center 2012 > Orchestrator – Průvodce aktivitou příkazového řádku nástroje Orchestrator > .
Po načtení průvodce vyberte tlačítko Načíst existující sestavení na první stránce.
Vyberte existující soubor sestavení a pak vyberte Otevřít. Zobrazí se název a umístění souboru sestavení.
Upravte cestu k souboru tak, aby se změny uložily do nového souboru. V případě potřeby můžete také změnit název sestavení.
Pokud potřebujete provést další změny podrobností o informacích o sestavení, vyberte tlačítko Informace o sestavení a proveďte tyto změny. Po dokončení se kliknutím na tlačítko OK vraťte na stránku Podrobnosti sestavení.
Výběrem možnosti Další přejdete na stránku Příkazy. Měl by se zobrazit seznam příkazů, které byly dříve definovány v sestavení. V případě potřeby zkontrolujte příkazy a výběrem možnosti Další pokračujte na stránku Sestavení budovy.
Vaše nové sestavení se sestaví za vás a uloží pomocí cesty a názvu souboru, který jste definovali dříve.
Nyní můžete použít nové sestavení kompatibilní s orchestratorem v runboocích s aktivitou Invoke .NET nebo můžete sestavit integrační balíček z tohoto sestavení výběrem tlačítka Sestavit integrační balíček . Pokud v tuto chvíli nechcete vytvořit IP adresu, vyberte Zavřít a ukončete průvodce.

Prostředky orchestratoru

Kromě této online reference poskytované pro System Center 2012 Orchestrator existuje celá řada zdrojů informací, které můžou poskytnout další informace o vytváření runbooků, s využitím integrační sady nástrojů a osvědčených postupů.

Sdílet prostřednictvím