Коллекции модулей Runbook и других модулей для службы автоматизации AzureRunbook and module galleries for Azure Automation

Вы можете не создавать собственные модули Runbook и другие модули в службе автоматизации Azure, а воспользоваться разнообразными сценариями, уже созданными корпорацией Майкрософт и сообществом.Rather than creating your own runbooks and modules in Azure Automation, you can access a variety of scenarios that have already been built by Microsoft and the community. Эти готовые сценарии можно применять без изменений или использовать в качестве отправной точки, модифицируя их под свои задачи.You can either use these scenarios without modification or you can use them as a starting point and edit them for your specific requirements.

Модули Runbook можно получить из коллекции Runbook, а другие модули — из коллекции PowerShell.You can get runbooks from the Runbook Gallery and modules from the PowerShell Gallery. Также вы можете поделиться с сообществом сценариями, которые вы разработали.You can also contribute to the community by sharing scenarios that you develop.

Коллекция Runbook содержит разнообразные модули Runbook, созданные корпорацией Майкрософт и сообществом, которые вы можете импортировать в службу автоматизации Azure.The Runbook Gallery provides a variety of runbooks from Microsoft and the community that you can import into Azure Automation. Модуль runbook можно скачать из коллекции, размещенной в центре скриптов TechNet, или импортировать непосредственно из коллекции на классическом портале Azure и портале Azure.You can either download a runbook from the gallery, which is hosted in the TechNet Script Center, or you can directly import runbooks from the gallery from either the Azure classic portal or Azure portal.

Импорт из коллекции Runbook можно выполнить только через классический портал Azure или портал Azure.You can only import directly from the Runbook Gallery using the Azure classic portal or Azure portal. Windows PowerShell не поддерживает эту функцию.You cannot perform this function using Windows PowerShell.

Примечание

Обязательно проверяйте содержимое всех модулей Runbook, которые вы получаете из коллекции Runbook, и соблюдайте предельную осторожность при их установке и запуске в рабочей среде.|You should validate the contents of any runbooks that you get from the Runbook Gallery and use extreme caution in installing and running them in a production environment.|

  1. На портале Azure последовательно выберите Создать, Службы приложений, Автоматизация, Runbook, Из коллекции.In the Azure portal, click, New, App Services, Automation, Runbook, From Gallery.
  2. Вы можете выбрать категорию, чтобы просмотреть соответствующие модули Runbook, или выбрать модуль Runbook, чтобы увидеть информацию о нем.Select a category to view related runbooks, and select a runbook to view its details. Когда вы найдете нужный модуль Runbook, нажмите кнопку со стрелкой вправо.When you select the runbook you want, click the right arrow button.

    Коллекция Runbook

  3. Просмотрите содержимое модуля Runbook и изучите требования, указанные в описании.Review the contents of the runbook and note any requirements in the description. После этого нажмите кнопку со стрелкой вправо.Click the right arrow button when you’re done.
  4. Введите информацию о модуле Runbook, а затем нажмите кнопку c галочкой.Enter the runbook details and then click the checkmark button. Имя модуля runbook будет уже указано.The runbook name is already filled in.
  5. Модуль runbook появится на вкладке Модули runbook учетной записи службы автоматизации.The runbook appears on the Runbooks tab for the Automation Account.
  1. На портале Azure выберите свою учетную запись службы автоматизации.In the Azure portal, open your Automation account.
  2. Щелкните плитку Модули Runbook , чтобы открыть список модулей Runbook.Click on the Runbooks tile to open the list of runbooks.
  3. Нажмите кнопку Обзор коллекции .Click Browse gallery button.

    Кнопка «Обзор коллекции»

  4. Найдите нужный элемент коллекции и выберите его, чтобы просмотреть сведения о нем.Locate the gallery item you want and select it to view its details.

    Обзор коллекции

  5. Щелкните Просмотреть исходный проект , чтобы открыть соответствующий элемент в центре сценариев TechNet.Click on View source project to view the item in the TechNet Script Center.
  6. Чтобы импортировать элемент, щелкните его, а затем в окне просмотра сведений нажмите кнопку Импорт .To import an item, click on it to view its details and then click the Import button.

    Кнопка «Импорт»

  7. Также для импорта модуля Runbook вы можете изменить его имя, а затем нажать кнопку ОК .Optionally, change the name of the runbook and then click OK to import the runbook.
  8. Модуль runbook появится на вкладке Модули runbook учетной записи службы автоматизации.The runbook appears on the Runbooks tab for the Automation Account.

Корпорация Майкрософт рекомендует добавлять в коллекцию модули Runbook, которые, на ваш взгляд, могут пригодиться другим клиентам.Microsoft encourages you to add runbooks to the Runbook Gallery that you think would be useful to other customers. Чтобы добавить модуль Runbook, передайте его в центр сценариев. При этом учтите следующие требования:You can add a runbook by uploading it to the Script Center taking into account the following details.

  • Чтобы модуль Runbook отображался в мастере, нужно указать значение Windows Azure для параметра Категория и значение Автоматизация для параметра Подкатегория.You must specify Windows Azure for the Category and Automation for the Subcategory for the runbook to be displayed in the wizard.
  • Следует передать только один файл с расширением .ps1 или .graphrunbook.The upload must be a single .ps1 or .graphrunbook file. Если для работы модуля Runbook нужны дополнительные модули, дочерние модули Runbook или любые ресурсы, их следует указать в описании при передаче, а также в разделе примечаний модуля Runbook.If the runbook requires any modules, child runbooks, or assets, then you should list those in the description of the submission and in the comments section of the runbook. Если ваш сценарий включает несколько модулей Runbook, передайте каждый из них отдельно и в каждом из описаний укажите имена связанных модулей Runbook.If you have a scenario requiring multiple runbooks, then upload each separately and list the names of the related runbooks in each of their descriptions. Обязательно используйте одинаковые теги, чтобы все модули отображались в одной категории.Make sure that you use the same tags so that they show up in the same category. Из описания пользователь сможет узнать, что для работы сценария нужны другие модули Runbook.A user will have to read the description to know that other runbooks are required the scenario to work.
  • Добавьте тег GraphicalPS при публикации графического модуля Runbook (не графического рабочего процесса).Add the tag "GraphicalPS" if you are publishing a Graphical runbook (not a Graphical Workflow).
  • Вставьте фрагмента кода PowerShell или рабочего процесса PowerShell в описание, используя значок Insert code section (Вставить раздел кода).Insert either a PowerShell or PowerShell Workflow code snippet into the description using Insert code section icon.
  • Сводка переданного файла будет отображаться в результатах поиска по коллекции runbook, поэтому вам следует указать подробные сведения о функциональных возможностях этого модуля runbook.The Summary for the upload is displayed in the Runbook Gallery results so you should provide detailed information that helps a user identify the functionality of the runbook.
  • Добавьте к передаваемому файлу от одного до трех тегов из списка ниже.You should assign one to three of the following Tags to the upload. В мастере этот модуль runbook будет указываться в категориях, которые соответствуют этим тегам.The runbook is listed in the wizard under the categories that match its tags. Мастер будет игнорировать теги, не включенные в этот список.Any tags not on this list are ignored by the wizard. Если вы не укажете теги, ваш модуль runbook будут отнесен к категории "Другие".If you don’t specify any matching tags, the runbook is listed under the Other category.

    • Резервное копированиеBackup
    • Управление емкостью;Capacity Management
    • управление изменениями;Change Control
    • Соответствие нормативным требованиямCompliance
    • среды разработки и тестирования;Dev / Test Environments
    • Аварийное восстановлениеDisaster Recovery
    • МониторингMonitoring
    • установка исправлений;Patching
    • ПодготовкаProvisioning
    • ИсправлениеRemediation
    • управление жизненным циклом виртуальной машины.VM Lifecycle Management
  • Служба автоматизации обновляет коллекцию один раз в час, поэтому вы не сразу увидите в ней добавленный модуль Runbook.Automation updates the Gallery once an hour, so you won’t see your contributions immediately.

Модули PowerShell содержат командлеты, которые можно использовать в модулях Runbook, а в коллекции PowerShell собраны готовые модули, которые можно установить в службе автоматизации Azure.PowerShell modules contain cmdlets that you can use in your runbooks, and existing modules that you can install in Azure Automation are available in the PowerShell Gallery. Вы можете открыть эту коллекцию на портале Azure и устанавливать модули из нее непосредственно в службе автоматизации Azure. Также вы можете скачать модули для установки вручную.You can launch this gallery from the Azure portal and install them directly into Azure Automation or you can download them and install them manually. Модули нельзя устанавливать непосредственно с классического портала Azure, но вы можете скачать и установить их, как любой другой модуль.You cannot install the modules directly from the Azure classic portal, but you can download them install them as you would any other module.

  1. На портале Azure выберите свою учетную запись службы автоматизации.In the Azure portal, open your Automation account.
  2. Выберите Модули в разделе Общие ресурсы чтобы открыть список модулей.Select Modules under Shared Resources to open the list of modules.
  3. В верхней части страницы щелкните Обзор коллекции.Click Browse gallery from the top of the page.

    Коллекция модулей

  4. На странице Обзор коллекции можно выполнить поиск по следующим полям:On the Browse gallery page, you can search by the following fields:

    • Имя модуляModule Name
    • ТегиTags
    • АвторAuthor
    • Командлет или имя ресурса DSCCmdlet/DSC resource name
  5. Найдите интересующий вас модуль и выберите его, чтобы просмотреть сведения.Locate a module that you're interested in and select it to view its details.
    При детализации конкретного модуля можно просмотреть дополнительные сведения о нем, включая ссылку на коллекцию PowerShell, все необходимые зависимости и все командлеты и (или) ресурсы DSC, которые содержит модуль.When you drill into a specific module, you can view more information about the module, including a link back to the PowerShell Gallery, any required dependencies, and all of the cmdlets and/or DSC resources that the module contains.

    Сведения о модуле PowerShell

  6. Чтобы установить модуль непосредственно в службу автоматизации Azure, нажмите кнопку Импорт .To install the module directly into Azure Automation, click the Import button.

    Кнопка импорта модуля

  7. Когда на панели Импорт вы нажмете одноименную кнопку, вы увидите имя импортируемого модуля.When you click the Import button, on the Import pane, you see the module name that you are about to import. Если установлены все зависимости, кнопка ОК будет активна.If all the dependencies are installed, the OK button is activated. Если какие-либо зависимости отсутствуют, необходимо будет импортировать их перед импортом этого модуля.If you are missing dependencies, you need to import those before you can import this module.
  8. Щелкните ОК, чтобы импортировать модуль.Click OK to import the module. Когда служба автоматизации Azure импортирует модуль в вашу учетную запись, она извлекает метаданные о модуле и командлетах.While Azure Automation imports a module to your account, it extracts metadata about the module and the cmdlets.

    Страница импорта модуля

    Это может занять несколько минут, поскольку каждое действие необходимо извлечь.This may take a couple of minutes since each activity needs to be extracted.

  9. Вы получите два уведомления о начале и завершении развертывания модуля соответственно.You receive an initial notification that the module is being deployed and another notification when it has completed.
  10. Когда модуль будет импортирован, вы увидите доступные действия и сможете использовать его ресурсы в модулях runbook и ресурсах настройки требуемого состояния.After the module is imported, you can see the available activities, and you can use its resources in your runbooks and Desired State Configuration.

Запрос на создание модуля Runbook или другого модуляRequesting a runbook or module

Свой запрос можно отправить на сайте User Voice.You can send requests to User Voice. Если вам нужна помощь в написании модуля Runbook или освоении PowerShell, опубликуйте вопрос на нашем форуме.If you need help writing a runbook or have a question about PowerShell, post a question to our forum.

Дальнейшие действияNext Steps