Создание графических модулей Runbook в службе автоматизации Azure
Внимание
служба автоматизации Azure учетные записи запуска от имени, включая классические учетные записи запуска от имени, отставили 30 сентября 2023 года и заменили управляемыми удостоверениями. Вы больше не сможете создавать или обновлять учетные записи запуска от имени через портал Azure. Дополнительные сведения см. в статье Переход от существующих учетных записей запуска от имени к управляемому удостоверению.
Все модули Runbook в службе автоматизации Azure представляют собой рабочие процессы Windows PowerShell. Графические модули Runbook и графические модули Runbook рабочего процесса PowerShell создают код PowerShell, который запускается рабочими ролями службы автоматизации. Вы не можете просмотреть или изменить этот код. Графический модуль Runbook можно преобразовать в графический модуль Runbook рабочего процесса PowerShell и наоборот. Однако эти модули Runbook нельзя преобразовать в текстовый модуль Runbook. Кроме того, графический редактор службы автоматизации не может импортировать текстовый модуль Runbook.
Графическая разработка позволяет создавать модули Runbook для службы автоматизации Azure без необходимости написания кода в рамках рабочего процесса PowerShell или использования Windows PowerShell. Вы добавляете на холст действия из библиотеки командлетов и модулей Runbook, а затем связываете и настраиваете их, создавая рабочий процесс. Если вам приходилось работать с System Center Orchestrator или Service Management Automation (SMA), графическая разработка не вызовет сложностей. Эта статья содержит вводные сведения об основных понятиях, необходимые, чтобы приступить к созданию графического модуля Runbook.
Примечание.
Вы не можете добавить цифровую подпись в графический модуль Runbook. Эта функция не поддерживается в служба автоматизации Azure.
Обзор графического редактора
Графический редактор можно открыть на портале Azure, создав или открыв для редактирования графический Runbook.
В следующих разделах описываются элементы управления в графическом редакторе.
Элемент управления "Холст"
Элемент управления "Холст" позволяет проектировать модуль Runbook. Вы можете добавлять в Runbook действия из узлов в элементе управления "Библиотека" и соединять их с помощью связей, чтобы определить логику Runbook. Для увеличения и уменьшения масштаба можно использовать элементы управления в нижней части холста.
Элемент управления "Библиотека"
Поле Элемент управления библиотекой позволяет выбирать действия для добавления в runbook. Вы добавляете их на холст, где можете соединить их с другими действиями. Элемент управления "Библиотека" содержит разделы, определенные в следующей таблице.
| Раздел | Описание |
|---|---|
| Командлеты | Все командлеты, которые могут использоваться в модуле Runbook. Командлеты группируются по модулям. Доступны все модули, которые установлены в учетной записи службы автоматизации. |
| Модули runbook | Модули Runbook в учетной записи службы автоматизации. Эти модули Runbook можно добавлять на холст, чтобы использовать их как дочерние модули. Отображаются только модули Runbook, тип которых совпадает с типом редактируемого модуля Runbook. Для графических модулей Runbook отображаются только модули Runbook на основе PowerShell. Для графических модулей Runbook рабочего процесса PowerShell отображаются только модули Runbook на основе рабочих процессов PowerShell. |
| Ресурсы | Содержит ресурсы службы автоматизации в учетной записи службы автоматизации, которые можно использовать в модуле Runbook. При добавлении ресурса в модуль Runbook добавляется действие рабочего процесса, которое получает выбранный ресурс. В случае ресурсов переменных можно либо добавить действие для получения переменной, либо задать переменную. |
| Элемент управления "Runbook" | Действия элемента управления "Модуль Runbook", которые могут использоваться в текущем модуле Runbook. Действие "Соединение" принимает несколько наборов входных данных и ожидает завершения их обработки, прежде чем продолжать рабочий процесс. Действие "Код" выполняет одну или несколько строк кода PowerShell или рабочего процесса PowerShell в зависимости от типа графического модуля Runbook. Это действие можно использовать в пользовательском коде или функции, которую не удается реализовать иными способами. |
Управление конфигурацией
Элемент управления "Конфигурация" позволяет указывать сведения для объекта, выбранного на холсте. Свойства, доступные в этом элементе управления, зависят от типа выбранного объекта. При выборе параметра в элементе управления "Конфигурация" открываются дополнительные колонки с дополнительной информацией.
Элемент управления "Тест"
Элемент управления "Тест" не отображается при первом запуске графического редактора. Он открывается, когда вы интерактивно тестируете графический модуль Runbook.
Использование действий
Действия являются стандартными блоками модуля Runbook. Действием может быть командлет PowerShell, дочерний Runbook или рабочий процесс. Вы можете добавить действие в модуль Runbook, щелкнув его правой кнопкой мыши в элементе управления "Библиотека" и выбрав пункт Добавить на холст. Затем можно щелкнуть и перетащить действие, чтобы поместить его на холсте туда, куда необходимо. Расположение действия на холсте никак не влияет на работу модуля Runbook. Модуль Runbook можно располагать любым способом, который сочтете наиболее подходящим для визуализации его работы.
Выберите действие на холсте, чтобы настроить его свойства и параметры в колонке "Конфигурация". Вы можете заменить метку действия именем, которое будет его описывать. Модуль Runbook по-прежнему выполняет исходный командлет. Вы просто изменяете отображаемое имя, используемое в графическом редакторе. Учтите, что метки должны быть уникальными в пределах модуля Runbook.
Наборы параметров
Набор параметров определяет обязательные и необязательные параметры, которые принимают значения для определенного командлета. У каждого командлета имеется по крайней мере один набор параметров, а у некоторых их несколько. Если у командлета несколько наборов параметров, перед настройкой параметров необходимо выбрать, какой из них использовать. Можно изменить набор параметров, используемый действием, щелкнув Набор параметров и выбрав другой набор. В этом случае все уже настроенные значения параметров будут потеряны.
В следующем примере у командлета Get-AzVM три набора параметров. В примере используется один набор с именем ListLocationVirtualMachinesParamSet с одним необязательным параметром, чтобы вернуть расположение для перечисленных виртуальных машин. В примере также используется набор параметров GetVirtualMachineInResourceGroupParamSet для указания возвращаемой виртуальной машины. Этот набор содержит два обязательных параметра и один необязательный параметр.
Значения параметров
При указании значения для параметра вы выбираете источник данных, чтобы определить, как будет указано значение. Источники данных, доступные для определенного параметра, зависят от допустимых значений для этого параметра. Например, значение NULL недоступно для параметра, который не допускает значений NULL.
| Источник данных | Description |
|---|---|
| Постоянное значение | Введите значение для параметра. Этот источник данных доступен только для следующих типов данных: Int32, Int64, String, Boolean, DateTime, Switch. |
| Выходные данные действия | Используйте выходные данные действия, предшествующего текущему действию в рабочем процессе. Будут перечислены все допустимые действия. Для значения параметра используйте только действие, которое создает выходные данные. Если действие выводит объект с несколькими свойствами, после выбора действия можно ввести имя конкретного свойства. |
| Входные данные Runbook | Выберите входные данные модуля Runbook в качестве входных данных для параметра действия. |
| Ресурс переменной | Выберите переменную службы автоматизации в качестве входных данных. |
| Ресурс учетных данных | Выберите учетные данные службы автоматизации в качестве входных данных. |
| Ресурс сертификата | Выберите сертификат службы автоматизации в качестве входных данных. |
| Ресурс подключения | Выберите подключение службы автоматизации в качестве входных данных. |
| Выражение PowerShell | Укажите простое выражение PowerShell. Выражение оценивается перед выполнением действия, и его результат используется в качестве значения параметра. Вы можете использовать переменные, чтобы ссылаться на выходные данные действия или входной параметр Runbook. |
| Не настроено | Очищает все значения, которые были настроены ранее. |
Необязательные дополнительные параметры
Для всех командлетов можно предоставить дополнительные параметры. Это могут быть общие параметры PowerShell или другие пользовательские параметры. В графическом редакторе появится текстовое поле, где можно будет указать параметры с помощью синтаксиса PowerShell. Например, чтобы использовать общий параметр Verbose, необходимо указать -Verbose:$True.
Повтор действий
Возможность повтора обеспечивает многократное выполнение действий — пока не будет выполнено определенное условие, как в цикле. Эта функция используется для действий, которые необходимо выполнить несколько раз (включая те, которые могут выполняться с ошибками), а также для проверки допустимости выходных данных действия.
Включая для действия режим повтора, можно задать условие и значение задержки. Задержка — это время (в секундах или минутах) ожидания модуля runbook перед повторным выполнением действия. Если задержка не указана, действие выполняется снова сразу же после завершения.
Условие повтора — это выражение PowerShell, которое вычисляется после каждого выполнения действия. Если выражение возвращает значение True, действие выполняется повторно. Если выражение возвращает значение False, действие не выполняется повторно, а модуль Runbook переходит к следующему действию.
В качестве условия повтора может использоваться переменная с именем RetryData, которая предоставляет доступ к сведениям о попытках выполнить действие. У этой переменной есть свойства, приведенные в таблице ниже.
| Свойство | Description |
|---|---|
NumberOfAttempts |
Количество запусков действия. |
Output |
Результат последнего выполнения действия. |
TotalDuration |
Время с момента первого запуска действия. |
StartedAt |
Время первого запуска действия в формате UTC. |
Ниже приведены примеры условий, при которых действие выполняется повторно.
# Run the activity exactly 10 times.
$RetryData.NumberOfAttempts -ge 10
# Run the activity repeatedly until it produces any output.
$RetryData.Output.Count -ge 1
# Run the activity repeatedly until 2 minutes has elapsed.
$RetryData.TotalDuration.TotalMinutes -ge 2
Когда вы настроите для действия условия запуска повторных попыток, действие будет отображать два напоминания. Одно включено в само действие, а второе отображается при проверке конфигурации действия.
Элемент управления сценария рабочего процесса
Элемент управления "Сценарий" рабочего процесса — это специальное действие, которое принимает сценарий PowerShell или рабочего процесса PowerShell (в зависимости от типа создаваемого графического модуля Runbook), обеспечивая возможности, которые иначе могут быть недоступными. Этот элемент управления предоставляет функциональные возможности, которые могут быть недоступны в других средствах. Он не может принимать параметры, но может использовать переменные для выходных данных действия и входных параметров Runbook. Все выходные данные действия добавляются в шину данных. Исключением являются выходные данные без исходящей связи. В этом случае выходные данные добавляются в выходные данные модуля Runbook.
Например, следующий код выполняет вычисление дат с помощью входной переменной модуля Runbook — NumberOfDays. Затем он отправляет вычисленную дату и время как выходные данные для использования последующими действиями в модуле Runbook.
$DateTimeNow = (Get-Date).ToUniversalTime()
$DateTimeStart = ($DateTimeNow).AddDays(-$NumberOfDays)}
$DateTimeStart
Использование связей для рабочего процесса
Связь в графическом модуле Runbook соединяет два действия. Она отображается на холсте как стрелка от исходного действия к действию назначения. Действия выполняются в направлении стрелки: действие назначения запускается после завершения исходного действия.
Создание ссылки
Можно создать связь между двумя действиями, выбрав исходное действие и щелкнув круг в нижней части фигуры. Перетащите стрелку к действию назначения и отпустите ее.
Выберите связь, чтобы настроить ее свойства в колонке "Конфигурация". Свойства включают тип связи, который описан в следующей таблице.
| Тип ссылки | Description |
|---|---|
| Pipeline | Действие назначения выполняется один раз для каждого вывода объекта из исходного действия. Действие назначения не выполняется, если исходное действие не создает выходные данные. Выходные данные из исходного действия доступны в виде объекта. |
| Sequence | Действие назначения выполняется только один раз при получении выходных данных из исходного действия. Выходные данные из исходного действия доступны в виде массива объектов. |
Действие запуска модуля Runbook
Графический модуль runbook начнется с любых действий, у которых нет входящей связи. Часто существует только одно действие, которое выступает в качестве начального действия модуля Runbook. Если у нескольких действий нет входящих связей, модуль Runbook запустится при их одновременном выполнении. Затем, по завершении каждого из них, он будет переходить по связям, выполняя другие действия.
Указание условий связи
Если для связи указано условие, действие назначения выполняется, только если условие возвращает значение True. Для извлечения результата из исходного действия обычно используется переменная ActivityOutput в условии.
Для связи конвейера необходимо указать условие для одного объекта. Модуль Runbook вычисляет условие для выходных данных каждого выходного объекта с помощью исходного действия. Затем он выполняет действие с каждым объектом, который удовлетворяет условию. Например, если исходное действие — Get-AzVM, следующий синтаксис можно использовать в условной последовательной связи для получения только виртуальных машин, входящих в группу ресурсов Group1.
$ActivityOutput['Get Azure VMs'].Name -match "Group1"
Для последовательной связи модуль Runbook вычисляет условие только один раз, так как возвращается один массив, содержащий все объекты из исходного действия. В связи с этим модуль Runbook не может использовать последовательную связь для фильтрации, как это можно сделать с помощью связи конвейера. Последовательная связь может просто определить, выполняется ли следующее действие.
Рассмотрим в качестве примера следующий набор действий в модуле Runbook для запуска виртуальной машины.
Модуль Runbook использует три различные связи с последовательностями, которые проверяют значения входных параметров VMName и ResourceGroupName для определения необходимого действия. Возможные действия: запуск одной виртуальной машины, запуск всех виртуальных машин в группе ресурсов или запуск всех виртуальных машин в подписке. Ниже приведена логика условия для связи с последовательностью между Connect to Azure и Get single VM.
<#
Both VMName and ResourceGroupName runbook input parameters have values
#>
(
(($VMName -ne $null) -and ($VMName.Length -gt 0))
) -and (
(($ResourceGroupName -ne $null) -and ($ResourceGroupName.Length -gt 0))
)
При использовании условной связи данные из исходного действия, доступные для других действий в этой ветви, фильтруются по условию. Если действие является источником нескольких связей, данные, доступные для действий в каждой ветви, зависят от условия в связи, присоединенной к этой ветви.
Например, действие Start-AzVM в модуле Runbook ниже запускает все виртуальные машины. Действие включает две условные связи. Первая условная ссылка использует выражение $ActivityOutput['Start-AzVM'].IsSuccessStatusCode -eq $true для фильтрации успешного завершения действия Start-AzVM. Вторая условная ссылка использует выражение $ActivityOutput['Start-AzVM'].IsSuccessStatusCode -ne $true для фильтрации, если действию Start-AzVm не удается запустить виртуальную машину.
Любое действие, следующее по первой связи и использующее выходные данные действия Get-AzureVM, получит только виртуальные машины, которые были запущены на момент выполнения действияGet-AzureVM. Любое действие, которое следует по второй связи, получит только виртуальные машины, которые были остановлены на момент выполнения действия Get-AzureVM. Действие, следующее по третьей связи, получит все виртуальные машины вне зависимости от того, запущены они или нет.
Использование соединений
Соединение — это специальное действие, которое ожидает завершения всех входящих ветвей. Это дает возможность модулю Runbook параллельно выполнять несколько действий и гарантировать, что все они будут завершены перед выполнением следующего шага.
Хотя у соединения может быть неограниченное число входящих связей, конвейерной может быть только одна из них. Число входящих последовательных связей не ограничено. Вы сможете создать соединение с несколькими входящими конвейерными связями и сохранить модуль Runbook, но его запуск завершится ошибкой.
В приведенном ниже примере показана часть Runbook, которая запускает набор виртуальных машин, одновременно скачивая исправления для них. Она использует соединение, чтобы гарантировать, что оба процесса будут выполнены, прежде чем выполнение модуля Runbook будет продолжено.
Работа с циклами
Циклический процесс формируется, когда действие назначения обратно связывается с исходным действием или другим действием, которое в конечном итоге обратно связывается с его исходным действием. В настоящее время графическая разработка не поддерживает циклы. Если runbook содержит циклический процесс, он будет сохранен правильно, но при его выполнении произойдет ошибка.
Обмен данными между действиями
Любые данные, которые выводятся действием с исходящей связью, записываются в шину данных для модуля Runbook. Любое действие в Runbook может использовать данные в шине данных, чтобы заполнить значения параметров или добавить эти данные в код сценария. Действие может обращаться к выходным данным любого предыдущего действия в рабочем процессе.
То, как данные записываются в шину данных, зависит от типа связи действия. Для конвейерной связи данные выводятся в виде нескольких объектов. Для последовательной связи данные выводятся в виде массива. Если имеется только одно значение, оно выводится в виде одноэлементного массива.
Модуль Runbook может получать доступ к данным в шине данных двумя способами:
- с использованием источника выходных данных действия;
- с использованием источника данных выражения PowerShell.
Первый механизм использует источник данных выходных данных действия для заполнения параметра другого действия. Если выходными данными является объект, модуль Runbook может указать одно свойство.
Второй механизм доступа к данным получает выходные данные действия в источнике данных выражения PowerShell или действие сценария рабочего процесса с переменной ActivityOutput, используя приведенный ниже синтаксис. Если выходными данными является объект, модуль Runbook может указать одно свойство.
$ActivityOutput['Activity Label']
$ActivityOutput['Activity Label'].PropertyName
Использование контрольных точек
В графическом модуле Runbook рабочего процесса PowerShell можно указать контрольные точки, выбрав параметр Создать контрольную точку модуля Runbook для любого действия. Это настраивает создание контрольной точки после выполнения действия.
Контрольные точки доступны только в графических модулях Runbook рабочего процесса PowerShell (соответственно, в графических модулях Runbook они недоступны). Если модуль Runbook использует командлеты Azure, он должен выполнять все действия с контрольными точками с помощью действия Connect-AzAccount. Операция подключения используется в случае, если модуль Runbook приостановлен и должен быть перезапущен из этой контрольной точки в другом рабочем процессе.
Обработка выходных данных модуля Runbook
Может потребоваться ввод от пользователя, запускающего модуль Runbook на портале Azure, или из другого модуля Runbook, если текущий используется в качестве дочернего. Например, для модуля Runbook, который создает виртуальную машину, при каждом запуске Runbook пользователю может потребоваться предоставлять такие данные, как имя виртуальной машины и другие свойства.
Модуль Runbook принимает входные данные, определяя один или несколько входных параметров. Пользователь указывает значения для этих параметров при каждом запуске Runbook. Когда пользователь запускает модуль Runbook с помощью портал Azure, ему предлагается указать значения для каждого входного параметра, поддерживаемого модулем Runbook.
При создании модуля Runbook его параметры можно открыть, нажав кнопку Вход и выход на панели инструментов Runbook. Откроется элемент управления "Вход и выход", в котором можно изменить существующий входной параметр или создать новый, нажав кнопку Добавить входные данные.
Каждый входной параметр определяется с помощью свойств, указанных в следующей таблице:
| Свойство | Описание |
|---|---|
| Имя. | Необходимые. Имя параметра. Имя должно быть уникальным в пределах модуля Runbook. Имя должно начинаться с буквы, оно может содержать только буквы, цифры и символы подчеркивания. Имя не может содержать пробел. |
| Description | Необязательно. Описание предназначения входного параметра. |
| Тип | Необязательно. Предполагаемый тип данных значения параметра. Портал Azure предоставит соответствующий элемент управления для типа данных каждого параметра при запросе ввода его значения. Поддерживаемые типы параметров: String, Int32, Int64, Decimal, Boolean, DateTime и Object. Если тип данных не выбран, то по умолчанию используется String. |
| Обязательно | Необязательно. Параметр, который указывает, должно ли быть задано значение для параметра. Если выбрано yes, при запуске модуля будет необходимо указывать значение. Если выбрано no, ввод значения при запуске модуля не будет обязательным и можно установить значение по умолчанию. Запустить Runbook не удастся, если не указать значение для каждого обязательного параметра, у которого нет определенного значения по умолчанию. |
| Значение по умолчанию | Необязательно. Значение, используемое для параметра, если перемер не передается при запуске модуля Runbook. Чтобы установить значение по умолчанию, выберите Custom. Выберите None, если не нужно использовать значения по умолчанию. |
Обработка выходных данных Runbook
Графическая разработка сохраняет в выходных данных модуля Runbook данные, созданные каким-либо действием,которые не имеют исходящей связи. Выходные данные сохраняются заданием Runbook и доступны родительскому модулю Runbook, если Runbook используется как дочерний.
Работа с выражениями PowerShell
Одним из преимуществ графической разработки является возможность создавать модули Runbook, располагая минимальными знаниями о PowerShell. В настоящее время необходимо знать лишь некоторые общие принципы работы с PowerShell для заполнения определенных значений параметров и настройки условий связи. В этом разделе содержатся краткие сведения о выражениях PowerShell. Полные сведения о PowerShell можно найти в статье Создание сценариев с помощью Windows PowerShell.
Использование выражения PowerShell в качестве источника данных
Выражение PowerShell можно использовать в качестве источника данных для заполнения значения параметра действия результатами кода PowerShell. Выражением может быть одна строка кода, которая выполняет простые функции, или несколько строк, выполняющие определенную сложную логику. Любые выходные данные команды, не присвоенные переменной, выводятся в значении параметра.
Например, следующая команда выводит текущую дату.
Get-Date
Следующий фрагмент кода создает строку из текущей даты и присваивают ее переменной. Затем код передает содержимое переменной в выходные данные.
$string = "The current date is " + (Get-Date)
$string
Следующие команды вычисляют текущую дату и возвращают строку, указывающую, является ли текущий день выходным или рабочим.
$date = Get-Date
if (($date.DayOfWeek = "Saturday") -or ($date.DayOfWeek = "Sunday")) { "Weekend" }
else { "Weekday" }
Использование выходных данных действия
Чтобы использовать выходные данные предыдущего действия в модуле Runbook, используйте переменную ActivityOutput со следующим синтаксисом.
$ActivityOutput['Activity Label'].PropertyName
Например, можно использовать действие со свойством, которое требует указать имя виртуальной машины. В этом случае модуль Runbook может применять следующее выражение.
$ActivityOutput['Get-AzureVM'].Name
При наличии свойства, требующего объект виртуальной машины только имени, модуль Runbook возвращает весь объект, используя следующий синтаксис.
$ActivityOutput['Get-AzureVM']
Модуль Runbook может использовать выходные данные действия в более сложном выражении, как показано ниже. Это выражение объединяет текст с именем виртуальной машины.
"The computer name is " + $ActivityOutput['Get-AzureVM'].Name
Сравнение значений
Используйте операторы сравнения для сравнения значений или определения того, соответствует ли значение указанному шаблону. Оператор сравнения возвращает значение True или False.
Например, следующее условие определяет, остановлена ли виртуальная машина из действия Get-AzureVM в данный момент.
$ActivityOutput["Get-AzureVM"].PowerState -eq "Stopped"
Следующее условие проверяет, находится ли та же виртуальная машина в любом состоянии, кроме остановленного.
$ActivityOutput["Get-AzureVM"].PowerState -ne "Stopped"
В модуле Runbook можно объединить несколько условий с помощью логического оператора, например -and или -or. Например, следующее условие проверяет, находится ли виртуальная машина из предыдущего примера в состоянии "Остановлена" или "Останавливается".
($ActivityOutput["Get-AzureVM"].PowerState -eq "Stopped") -or ($ActivityOutput["Get-AzureVM"].PowerState -eq "Stopping")
Использование хэш-таблиц
Хэш-таблицы представляют собой пары "имя-значение", которые удобны для получения набора значений. Иногда хэш-таблицу называют словарем. Свойства для определенных действий ожидают хэш-таблицу вместо простого значения.
Хэш-таблицу можно создать, используя следующий синтаксис. Она содержит любое количество записей, каждая из которых определяется именем и значением.
@{ <name> = <value>; [<name> = <value> ] ...}
Например, следующее выражение создает хэш-таблицу для использования в качестве источника данных для параметра действия, который ожидает хэш-таблицу со значениями для поиска в Интернете.
$query = "Azure Automation"
$count = 10
$h = @{'q'=$query; 'lr'='lang_ja'; 'count'=$Count}
$h
В следующем примере выходные данные действия Get X Connection используются для заполнения хэш-таблицы.
@{'ApiKey'=$ActivityOutput['Get X Connection'].ConsumerAPIKey;
'ApiSecret'=$ActivityOutput['Get X Connection'].ConsumerAPISecret;
'AccessToken'=$ActivityOutput['Get X Connection'].AccessToken;
'AccessTokenSecret'=$ActivityOutput['Get X Connection'].AccessTokenSecret}
Проверка подлинности в ресурсах Azure
В службе автоматизации Azure для модулей runbook, которые управляют ресурсами Azure, требуется проверка подлинности. Управляемые удостоверения — это механизм по умолчанию, используемый runbook службы автоматизации для доступа к ресурсам Azure Resource Manager в подписке. Эту функцию можно добавить в графический модуль Runbook, импортируя следующий модуль Runbook в учетную запись службы автоматизации, которая использует управляемое удостоверение, назначаемое системой, для проверки подлинности и доступа к ресурсам Azure.
wget https://raw.githubusercontent.com/azureautomation/runbooks/master/Utility/AzMI/AzureAutomationTutorialWithIdentityGraphical.graphrunbook -outfile AzureAutomationTutorialWithIdentityGraphical.graphrunbook
Экспорт графического модуля Runbook
Можно экспортировать только опубликованную версию графического модуля Runbook. Если модуль Runbook еще не опубликован, кнопка Экспорт недоступна. При нажатии кнопки Экспорт модуль Runbook скачивается на локальный компьютер. Имя файла соответствует имени модуля Runbook. Расширение файла — GRAPHRUNBOOK.
Импорт графического модуля Runbook
Файл графического модуля Runbook или графического модуля Runbook рабочего процесса PowerShell можно импортировать, выбрав параметр Импорт при добавлении модуля. При выборе файла для импорта можно сохранить то же имя или ввести новое. В поле Тип модуля Runbook отображается тип модуля Runbook после того, как он оценит выбранный файл. При попытке выбрать другой недопустимый тип в графическом редакторе выводится сообщение о существовании потенциальных конфликтов и возможном наличии синтаксических ошибок в процессе преобразования.
Тестирование графического модуля Runbook
У каждого графического модуля Runbook в службе автоматизации Azure есть черновая и опубликованная версии. Запускать можно только опубликованную версию, а изменять — только черновую. Изменения, внесенные в черновик, не влияют на опубликованную версию. Когда черновая версия готова к использованию, ее можно опубликовать, заменив текущую опубликованную версию содержимым черновой.
Черновик модуля Runbook можно протестировать на портале Azure, не изменяя при этом опубликованную версию. Или можно проверить новый модуль Runbook перед публикацией, чтобы убедиться в его правильной работе перед заменой версий. При тестировании модуля Runbook запускается его черновая версия и завершаются все действия, которые он выполняет. Журнал заданий не создается, но в области вывода теста отображаются выходные данные.
Откройте элемента управления "Тест" для графического модуля Runbook, открыв Runbook для редактирования и нажав кнопку области тестирования. Будет предложено ввести входные параметры, после чего вы сможете запустить модуль Runbook, нажав кнопку Запуск.
Публикация графического модуля Runbook
Графический модуль Runbook можно опубликовать, открыв его для редактирования и нажав кнопку Опубликовать. Возможные состояния модуля Runbook:
- Новый — модуль Runbook еще не опубликован.
- Опубликован — модуль Runbook опубликован.
- На изменении — модуль Runbook изменен после публикации, и черновая и опубликованная версии отличаются.
Имеется возможность восстановить опубликованную версию модуля Runbook. Эта операция отменяет все изменения, внесенные с момента последней публикации модуля Runbook. Он заменяет черновую версию модуля Runbook опубликованной версией.
Следующие шаги
- Сведения о начале работы с графическими модулями Runbook см. в руководстве по созданию графического модуля Runbook.
- См. сведения о типах runbook, их преимуществах и ограничениях в описании типов последовательностей runbook в службе автоматизации Azure
- Справочник по командлетам PowerShell см. в документации по Az.Automation.