Úprava textových runbooků ve službě Azure Automation

  • Článek

Textový editor ve službě Azure Automation můžete použít k úpravě runbooků PowerShellu a runbooků pracovních postupů PowerShellu. Tento editor má typické funkce jiných editorů kódu, jako je IntelliSense. Používá také barevné kódování s dalšími speciálními funkcemi, které vám pomůžou při přístupu k prostředkům běžným pro runbooky.

Textový editor obsahuje funkci pro vložení kódu pro rutiny, prostředky a podřízené runbooky do runbooku. Místo psaní v kódu sami můžete vybrat ze seznamu dostupných prostředků a editor vloží příslušný kód do runbooku.

Každý runbook ve službě Azure Automation má dvě verze: Koncept a Publikováno. Upravíte verzi konceptu runbooku a pak ji publikujete, aby bylo možné ji spustit. Publikovanou verzi nelze upravit. Další informace najdete v tématu Publikování runbooku.

Tento článek obsahuje podrobné kroky pro provádění různých funkcí v tomto editoru. Neplatí pro grafické runbooky. Pokud chcete s těmito runbooky pracovat, přečtěte si téma Grafické vytváření ve službě Azure Automation.

Důležité

Nezahrnujte klíčové slovo "AzureRm" do žádného skriptu navrženého ke spuštění pomocí modulu Az. Zahrnutí klíčového slova, a to i v komentáři, může způsobit načtení AzureRm a pak konflikt s modulem Az.

Úprava runbooku pomocí webu Azure Portal

  1. Na webu Azure Portal vyberte svůj účet Automation.
  2. V části AUTOMATIZACE PROCESŮ vyberte Runbooky a otevřete seznam runbooků.
  3. Zvolte runbook, který chcete upravit, a potom klikněte na Upravit.
  4. Upravte runbook.
  5. Po dokončení úprav klikněte na Uložit .
  6. Pokud chcete publikovat nejnovější verzi konceptu runbooku, klikněte na Publikovat .

Vložení rutiny do runbooku

  1. Na plátně textového editoru umístěte kurzor na místo, kam chcete rutinu umístit.
  2. Rozbalte uzel Rutiny v ovládacím prvku Knihovna.
  3. Rozbalte modul obsahující rutinu, která se má použít.
  4. Kliknutím pravým tlačítkem myši na název rutiny vložte a vyberte Přidat na plátno. Pokud má rutina více než jednu sadu parametrů, editor přidá výchozí sadu. Můžete také rozbalit rutinu a vybrat jinou sadu parametrů.
  5. Všimněte si, že kód rutiny se vloží s celým seznamem parametrů.
  6. Zadejte odpovídající hodnotu místo hodnoty obklopené úhlovými závorkami (<>) pro všechny požadované parametry. Odeberte všechny parametry, které nepotřebujete.

Vložení kódu podřízeného runbooku do runbooku

  1. Na plátně textového editoru umístěte kurzor na místo, kam chcete umístit kód podřízeného runbooku.
  2. Rozbalte uzel Runbooky v ovládacím prvku Knihovna.
  3. Kliknutím pravým tlačítkem myši na runbook vložte a vyberte Přidat na plátno.
  4. Kód podřízeného runbooku se vloží se zástupnými symboly pro všechny parametry runbooku.
  5. Zástupné symboly nahraďte odpovídajícími hodnotami pro každý parametr.

Vložení prostředku do runbooku

  1. V ovládacím prvku Plátno textového editoru umístěte kurzor na místo, kam chcete umístit kód podřízeného runbooku.
  2. Rozbalte uzel Assets v ovládacím prvku Knihovna.
  3. Rozbalte uzel pro požadovaný typ prostředku.
  4. Klikněte pravým tlačítkem myši na název prostředku, který chcete vložit, a vyberte Přidat na plátno. U prostředků proměnných vyberte možnost Přidat "Získat proměnnou" na plátno nebo Přidat "Nastavit proměnnou" na plátno v závislosti na tom, jestli chcete získat nebo nastavit proměnnou.
  5. Všimněte si, že kód prostředku se vloží do runbooku.

Úprava runbooku Azure Automation pomocí Windows PowerShellu

Pokud chcete upravit runbook pomocí Windows PowerShellu, použijte editor podle vašeho výběru a uložte runbook do souboru .ps1 . K načtení obsahu runbooku můžete použít rutinu Export-AzAutomationRunbook . Pomocí rutiny Import-AzAutomationRunbook můžete nahradit stávající runbook konceptu upraveným runbookem.

Načtení obsahu runbooku pomocí Windows PowerShellu

Následující ukázkové příkazy ukazují, jak načíst skript runbooku a uložit ho do souboru skriptu. V tomto příkladu se načte verze Konceptu. Je také možné načíst publikovanou verzi runbooku, i když tuto verzi nelze změnit.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Export-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -OutputFolder $scriptFolder -Slot Draft

Změna obsahu runbooku pomocí Windows PowerShellu

Následující ukázkové příkazy ukazují, jak nahradit existující obsah runbooku obsahem souboru skriptu.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Import-AzAutomationRunbook -Path "$scriptfolder\Hello-World.ps1" -Name $runbookName -Type PowerShell -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -Force
Publish-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName

Další kroky