Изменение текстовых последовательностей runbook в службе автоматизации Azure

  • Статья

Текстовый редактор в службе автоматизации Azure можно использовать для изменения последовательностей runbook PowerShell и последовательностей runbook рабочих процессов PowerShell. Этот редактор имеет стандартные функции редакторов кода, таких как IntelliSense. В нем также используется цветовая маркировка и дополнительные специальные функции, предназначенные для упрощения доступа к стандартным ресурсам runbook.

Текстовый редактор включает функцию, позволяющую вставлять в модуль runbook код для командлетов, ресурсов и дочерних модулей. Чтобы не вводить этот код самостоятельно, выберите его из списка доступных ресурсов, и редактор вставит соответствующий код в runbook.

У каждого модуля Runbook в службе автоматизации Azure есть черновая и опубликованная версия. Вы можете изменить черновую версию модуля Runbook, а затем опубликовать ее для последующего использования. Опубликованную версию изменить нельзя. Дополнительные сведения см. в разделе Публикация последовательности runbook.

В этой статье подробно описано, как использовать этот редактор для выполнения разнообразных задач. Инструкции для графических последовательностей runbook будут отличаться. Сведения о работе с такими последовательностями runbook приведены в статье Графическая разработка в службе автоматизации Azure.

Важно!

Не включайте ключевое слово "AzureRm" в скрипты, предназначенные для выполнения с помощью модуля Az. Добавление этого ключевого слова даже в комментарий может привести к загрузке AzureRm и конфликту с модулем Az.

Изменение последовательности runbook с помощью портала Azure

  1. На портале Azure выберите свою учетную запись службы автоматизации.
  2. В разделе Автоматизация процессов выберите Модули Runbook, чтобы открыть список модулей.
  3. Выберите последовательность runbook, которую нужно изменить, и нажмите кнопку Изменить.
  4. Внесите изменения в модуль runbook.
  5. Закончив изменения, нажмите кнопку Сохранить .
  6. Чтобы опубликовать последнюю черновую версию последовательности runbook, нажмите кнопку Опубликовать.

Вставка командлета в runbook

  1. На холсте текстового редактора установите курсор в то место, куда нужно вставить командлет.
  2. Разверните узел Командлеты в элементе управления «Библиотека».
  3. Откройте модуль, в котором находится нужный командлет.
  4. Щелкните правой кнопкой мыши имя командлета, который нужно вставить, и выберите Добавить на холст. Если у командлета больше одного набора параметров, редактор добавит набор параметров по умолчанию. Вы также можете развернуть командлет и выбрать другой набор параметров.
  5. Обратите внимание, что код для командлета вставляется с полным списком параметров.
  6. Укажите соответствующее значение вместо значения, окруженного угловой скобкой (<>) для любых обязательных параметров. Удалите ненужные параметры.

Вставка кода для дочерней последовательности runbook в последовательность runbook

  1. На холсте текстового редактора установите курсор в то место, куда нужно вставить код для дочерней последовательности runbook.
  2. Разверните узел Модули Runbook в элементе управления «Библиотека».
  3. Щелкните правой кнопкой мыши модуль runbook, который нужно вставить, и выберите Добавить на холст.
  4. Код для дочернего модуля Runbook вставляется со всеми заполнителями для всех параметров модуля Runbook.
  5. Замените заполнители на соответствующие значения для каждого параметра.

Вставка ресурса в runbook

  1. На холсте текстового редактора установите курсор в то место, куда нужно вставить код для дочерней последовательности runbook.
  2. Разверните узел Ресурс-контейнеры в элементе управления «Библиотека».
  3. Разверните узел для нужного типа ресурса.
  4. Щелкните правой кнопкой мыши имя ресурса, который нужно вставить, и выберите Добавить на холст. Для ресурсов-контейнеров переменных выберите Добавить "Получить переменную" на холст или Добавить "Установить переменную" на холст в зависимости от того, нужно ли вам получить или задать переменную.
  5. Обратите внимание, что код для ресурса вставляется в последовательность runbook.

Изменение последовательности runbook в службе автоматизации Azure с помощью Windows PowerShell

Чтобы изменить последовательность runbook с помощью Windows PowerShell, используйте любой редактор и сохраните ее в виде файла PS1. Для получения содержимого последовательности runbook можно использовать командлет Export-AzAutomationRunbook. Вы можете использовать командлет Import-AzAutomationRunbook, чтобы заменить существующую последовательность runbook на измененную.

Извлечение содержимого последовательности runbook с помощью Windows PowerShell

Команды в приведенном ниже примере показывают, как извлечь сценарий для модуля и сохранить его в файл сценария. В этом примере извлекается черновая версия. Извлечь можно также опубликованную версию последовательности runbook, но изменить ее нельзя.

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

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

Изменение содержимого последовательности runbook с помощью Windows PowerShell

Команды в приведенном ниже примере показывают, как заменить существующее содержимое модуля Runbook на содержимое файла сценария.

$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

Следующие шаги