Обновление модулей Azure PowerShell в службе автоматизации
Самые популярные модули PowerShell предоставляются по умолчанию в каждой учетной записи службы автоматизации. См. раздел Стандартные модули. Специалисты Azure регулярно обновляют модули Azure, и такие изменения могут затронуть включенные командлеты. Например, может произойти переименование параметра или прекращение поддержки командлета, что помешает работе ваших последовательностей runbook.
Примечание.
Вы не можете удалять глобальные модули, которые служба автоматизации предоставляет в стандартной конфигурации.
Настройка учетной записи службы автоматизации
Чтобы избежать негативного влияния на последовательности runbook и автоматизируемые процессы, выполняйте тестирование и проверку при любых обновлениях. Если у вас нет выделенной учетной записи службы автоматизации, предназначенной для этой цели, то рекомендуется ее создать, чтобы протестировать различные сценарии в процессе разработки модулей Runbook. Тестирование должно включать итеративные изменения, такие как обновление модулей PowerShell.
Убедитесь, что учетная запись службы автоматизации добавила управляемое удостоверение, назначаемое системой, или управляемое удостоверение, назначаемое пользователем.
Если вы разрабатываете скрипты локально, для тестирования рекомендуется сохранить локально те же версии модуля, которые используются в учетной записи службы автоматизации. Так вы гарантированно получите те же результаты. После проверки результатов и применения необходимых изменений можно перейти к процессу переноса их в рабочую среду.
Примечание.
Новая учетная запись службы автоматизации может не содержать последние модули.
Обновление модулей Az
В следующих разделах объясняется, как обновить модули Az с помощью портала (рекомендуется) или runbook.
Обновление модулей Az на портале
В настоящее время обновление модулей AZ доступно только на портале. Обновления с помощью PowerShell и шаблона ARM будут доступны в будущем. При выполнении следующих действий будут обновлены только стандартные модули Az.
Войдите на портал Azure и перейдите к учетной записи службы автоматизации Azure.
В разделе Общие ресурсы выберите Модули.
Выберите Обновить модули Az.
Выберите Модуль для обновления. По умолчанию будет отображаться модуль Az.
В раскрывающемся списке выберите версию модуля и версию Runtype
Нажмите Обновить, чтобы обновить модуль Az до выбранной версии. На странице "Модули" можно просмотреть список, как показано ниже:
Если выбрать версию ниже существующей версии модуля Az, импортированной в учетную запись службы автоматизации, операция обновления выполнит откат до выбранной версии.
Чтобы проверить операцию обновления, проверка свойству "Версия модуля" и "Состояние" обновленных модулей, отображаемых в списке модулей в модулях PowerShell.
Команда Azure регулярно обновляет версию модуля и предоставляет возможность обновить модули Az по умолчанию, выбрав версию модуля из раскрывающегося списка.
Обновление модулей Az с помощью runbook
Чтобы обновить модули Azure в учетной записи службы автоматизации, выполните следующие действия.
- Используйте модуль Runbook Update-AutomationAzureModulesForAccount, доступный как открытый код.
- Скачайте из репозитория GitHub, чтобы начать использовать этот модуль Runbook для обновления модулей Azure.
- Импортируйте его в учетную запись службы автоматизации или запустите его в качестве скрипта. Инструкции по импорту runbook в учетную запись службы автоматизации см. в статье Импорт runbook.
Примечание.
Мы рекомендуем обновить модули Az с помощью портал Azure. Это можно также сделать с помощью скрипта Update-AutomationAzureModulesForAccount , доступного как открытого исходного кода и предоставленного в качестве ссылки. Однако в случае сбоя модуля Runbook необходимо изменить параметры в модулю Runbook в соответствии с требованиями или выполнить отладку скрипта в соответствии с сценарием.
Последовательность runbook Update-AutomationAzureModulesForAccount по умолчанию поддерживает обновление модулей Azure, AzureRM и AZ. Дополнительные сведения об обновлении модулей Az.Automation с помощью этой последовательности runbook см. в этом файле сведений. При использовании модулей Az в учетной записи службы автоматизации необходимо учитывать дополнительные важные факторы. Дополнительные сведения см. в статье Администрирование модулей в службе автоматизации Azure.
Использование кода Runbook обновления в качестве обычного скрипта PowerShell
Вы можете выполнить код runbook в качестве обычного скрипта PowerShell. Для этого войдите в Azure с помощью командлета Connect-AzAccount, а затем передайте -Login $false в скрипт.
Использование runbook обновления в национальных облаках
Если вы хотите выполнять эту последовательность runbook в национальных облаках, используйте параметр AzEnvironment, чтобы передать в runbook нужную среду. Приемлемые значения: AzureCloud (общедоступное облако Azure), AzureChinaCloud, AzureGermanCloud и AzureUSGovernment. Эти значения можно получить с помощью Get-AzEnvironment | select Name. Если вы не передаете значение этому командлету, по умолчанию runbook использует AzureCloud.
Использование runbook обновления с конкретной версией модуля
Если вам важно использовать определенную версию модуля Azure, а не последнюю доступную в коллекции PowerShell, передайте все нужные версии в необязательном параметре ModuleVersionOverrides в runbook Update-AutomationAzureModulesForAccount. Примеры см. в модуле runbook Update-AutomationAzureModulesForAccount.ps1. Модули Azure PowerShell, которые не упомянуты в параметре ModuleVersionOverrides, обновляются до последних версий из коллекции PowerShell. Если в параметр ModuleVersionOverrides не передано ничего, все модули обновляются последними версиями из коллекции PowerShell, как при нажатии кнопки Обновить модули Azure на портале Azure.
Следующие шаги
- Дополнительные сведения см. в статье Администрирование модулей в службе автоматизации Azure.
- Дополнительные сведения о runbook обновления см. на странице репозитория этой последовательности runbook.