Типы модулей Runbook в службе автоматизации Azure

Ограничения

• Для версии среды выполнения PowerShell 7.2 действия модуля не извлекаются для импортированных модулей. Используйте расширение служба автоматизации Azure для VS code, чтобы упростить процесс разработки модуля Runbook.
• PowerShell 7.x не поддерживает рабочие процессы. Дополнительные сведения см. в рабочем процессе PowerShell.
• Сейчас PowerShell 7.x не поддерживает подписанные модули runbook.
• Интеграция системы управления версиями не поддерживает PowerShell 7.2. Кроме того, модули Runbook PowerShell 7.2 в системе управления версиями создаются в учетной записи службы автоматизации в качестве среды выполнения 5.1.
• По умолчанию устанавливается модуль Az 8.3.0. Полный список модулей компонентов выбранной версии модуля Az отображается после повторной настройки версии Az с помощью портал Azure или API.
• Импортированный модуль PowerShell 7.2 будет проверен во время выполнения задания. Убедитесь, что все зависимости выбранного модуля также импортируются для успешного выполнения задания.
• Модуль Runbook Azure не поддерживается Start-Job -credential.
• Azure не поддерживает все входные параметры PowerShell. Подробнее.

Известные проблемы

• Модули Runbook принимают зависимость от внутренних путей файлов, таких как C:\modules может завершиться сбоем из-за изменений в серверной инфраструктуре службы. Измените код runbook, чтобы гарантировать отсутствие зависимостей от внутренних путей к файлам и получение необходимых сведений о модуле с помощью Get-ChildItem .

• Get-AzStorageAccountкомандлет может завершиться ошибкой: Get-AzStorageAccount команда была найдена в модулеAz.Storage, но модуль не удалось загрузить.

• Выполнение дочерних скриптов .\child-runbook.ps1 не поддерживается.
  Обходное решение. Используйте Start-AutomationRunbook (внутренний командлет) или Start-AzAutomationRunbook (из модуля Az.Automation ) для запуска другого модуля Runbook из родительского модуля Runbook.

• При использовании модуля ExchangeOnlineManagement версии: 3.0.0 или более поздней, вы можете столкнуться с ошибками. Чтобы устранить проблему, убедитесь, что вы явно отправляете модули PowerShellGet и PackageManagement .

• При использовании командлета New-AzAutomationVariable в модуле Az.Automation для отправки переменной объекта типа операция не работает должным образом.

  Обходной путь. Преобразование объекта в строку JSON с помощью командлета ConvertTo-Json и отправки переменной со строкой JSON в качестве значения. Это решение обеспечивает правильную обработку переменной в среде служба автоматизации Azure в виде строки JSON.

  Пример . Создание объекта PowerShell с хранимыми сведениями о виртуальных машинах Azure

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

Ограничения

• Нельзя использовать параллельную обработку для одновременного выполнения нескольких действий.
• Модули runbook не могут использовать контрольные точки для возобновления в случае ошибки.
• Вы можете включать только модули Runbook PowerShell, Рабочие процессы PowerShell и графические модули Runbook в качестве дочерних модулей Runbook с помощью командлета Start-AzAutomationRunbook , который создает новое задание.
• Модули Runbook не могут использовать инструкцию PowerShell #Requires , она не поддерживается в песочнице Azure или гибридных рабочих ролей Runbook и может привести к сбою задания.
• Модуль Runbook Azure не поддерживается Start-Job -credential.
• Azure не поддерживает все входные параметры PowerShell. Подробнее.

Известные проблемы

• Модули Runbook принимают зависимость от внутренних путей файлов, таких как C:\modules может завершиться сбоем из-за изменений в серверной инфраструктуре службы. Измените код runbook, чтобы гарантировать отсутствие зависимостей от внутренних путей к файлам и получение необходимых сведений о модуле с помощью Get-ChildItem .

  Пример скрипта

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Get-AzStorageAccountкомандлет может завершиться ошибкой: Get-AzStorageAccount команда была найдена в модулеAz.Storage, но модуль не удалось загрузить.

• Модули runbook PowerShell не могут извлечь незашифрованный ресурс-контейнер переменной со значением NULL.

• Модули runbook PowerShell не имеют возможности извлекать ресурс-контейнер переменной, в имени которого есть символ *~*.

• Операция Get-Process в цикле в модуле runbook PowerShell может аварийно завершить работу после примерно 80 итераций.

• В работе модуля runbook PowerShell может произойти сбой, если он попытается записать слишком большой объем данных в поток вывода за один раз. Обычно эту проблему можно обойти, настроив модуль runbook так, чтобы при работе с большими объектами он выводил только необходимые данные. Например, вместо использования Get-Process без ограничений можно сделать так, чтобы командлет выводил только необходимые параметры, например Get-Process | Select ProcessName, CPU.

• При использовании модуля ExchangeOnlineManagement версии: 3.0.0 или более поздней, могут возникнуть ошибки. Чтобы устранить проблему, убедитесь, что вы явно отправляете модули PowerShellGet и PackageManagement .

• Если вы импортируете модуль Az.Accounts с версией 2.12.3 или более поздней, убедитесь, что модуль Newtonsoft.Json версии 10 явно импортируется, если модули Runbook PowerShell 5.1 имеют зависимость от этой версии модуля. Решение этой проблемы заключается в использовании модулей Runbook PowerShell 7.2.

• При использовании командлета New-AzAutomationVariable в модуле Az.Automation для отправки переменной объекта типа операция не работает должным образом.

  Обходной путь. Преобразование объекта в строку JSON с помощью командлета ConvertTo-Json и отправки переменной со строкой JSON в качестве значения. Это решение обеспечивает правильную обработку переменной в среде служба автоматизации Azure в виде строки JSON.

  Пример . Создание объекта PowerShell с хранимыми сведениями о виртуальных машинах Azure

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

Ограничения

• PowerShell 7.1 больше не поддерживается родительским продуктом PowerShell. Мы рекомендуем создать новые модули Runbook в PowerShell 7.2 для долгосрочной поддержки и обновить устаревшие модули Runbook.
• Внутренние командлеты PowerShell в Службе автоматизации Azure не поддерживаются в гибридной рабочей роли Runbook в Linux. Импортируйте модуль automationassets в начале выполнения runbook в PowerShell, чтобы получить доступ к функциям общих ресурсов в учетной записи Службы автоматизации.
• Для версии среды выполнения PowerShell 7не извлекаются действия для импортированных модулей.
• Тип параметра Runbook PSCredential не поддерживается в версии среды выполнения PowerShell 7.
• PowerShell 7.x не поддерживает рабочие процессы. Дополнительные сведения см. в разделе "Рабочий процесс PowerShell" для получения дополнительных сведений.
• Сейчас PowerShell 7.x не поддерживает подписанные модули runbook.
• Интеграция системы управления версиями не поддерживает powerShell 7.1 (предварительная версия) Кроме того, модули Runbook PowerShell 7.1 (предварительная версия) создаются в учетной записи службы автоматизации в качестве среды выполнения 5.1.
• Управление модулями PowerShell 7.1 с помощью командлетов Get-AzAutomationModule не поддерживается.
• Runbook завершается ошибкой без трассировки журнала, если входное значение содержит символ '.
• Модуль Runbook Azure не поддерживается Start-Job -credential.
• Azure не поддерживает все входные параметры PowerShell. Подробнее.

Известные проблемы

• Модули Runbook принимают зависимость от внутренних путей файлов, таких как C:\modules может завершиться сбоем из-за изменений в серверной инфраструктуре службы. Измените код runbook, чтобы гарантировать отсутствие зависимостей от внутренних путей к файлам и получение необходимых сведений о модуле с помощью Get-ChildItem .

  Пример скрипта

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Get-AzStorageAccountкомандлет может завершиться ошибкой: Get-AzStorageAccount команда была найдена в модулеAz.Storage, но модуль не удалось загрузить.

• Выполнение дочерних скриптов, использующихся .\child-runbook.ps1 , не поддерживается в этой предварительной версии. Обходное решение. Используйте Start-AutomationRunbook (внутренний командлет) или Start-AzAutomationRunbook (из Az.Automation модуля) для запуска другого модуля Runbook из родительского модуля.

• В среде выполнения PowerShell 7 не поддерживаются свойства runbook, определяющие настройку ведения журнала. Обходное решение. Явно задайте предпочтения в начале модуля Runbook следующим образом:

      $VerbosePreference = "Continue"
  
      $ProgressPreference = "Continue"
  

• Избегайте импорта Az.Accounts модуля в версию 2.4.0 для среды выполнения PowerShell 7, так как это может быть непредвиденное поведение с помощью этой версии в служба автоматизации Azure.

• Могут возникнуть проблемы с форматированием выходных потоков ошибок для задания, выполняемого в среде выполнения PowerShell 7.

• При импорте модуля PowerShell 7.1, зависящее от других модулей, можно обнаружить, что кнопка импорта серая, даже если установлена версия зависимого модуля PowerShell 7.1. Например, модуль Az PowerShell. Вычисление версии 4.20.0 зависит от Az.Accounts >= 2.6.0. Эта проблема возникает, когда эквивалентный зависимый модуль в PowerShell 5.1 не соответствует требованиям к версии. Например, 5.1 версия Az.Accounts была < 2.6.0.

• При запуске модуля Runbook PowerShell 7 с помощью веб-перехватчика он автоматически преобразует входной параметр веб-перехватчика в недопустимый JSON.

• Рекомендуется использовать версию модуля ExchangeOnlineManagement : 3.0.0 или более позднюю, так как версия: 3.0.0 или более поздней могут привести к сбоям заданий.

• Если вы импортируете модуль Az.Accounts с версией 2.12.3 или более поздней, убедитесь, что модуль Newtonsoft.Json версии 10 явно импортируется, если модули Runbook PowerShell 7.1 имеют зависимость от этой версии модуля. Решение этой проблемы заключается в использовании модулей Runbook PowerShell 7.2.

• При использовании командлета New-AzAutomationVariable в модуле Az.Automation для отправки переменной объекта типа операция не работает должным образом.

  Обходной путь. Преобразование объекта в строку JSON с помощью командлета ConvertTo-Json и отправки переменной со строкой JSON в качестве значения. Это решение обеспечивает правильную обработку переменной в среде служба автоматизации Azure в виде строки JSON.

  Пример . Создание объекта PowerShell с хранимыми сведениями о виртуальных машинах Azure

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

• В настоящее время для модулей Python 3.10 (предварительная версия) поддерживаются только файлы колес, предназначенные для ос Linux cp310. Подробнее
• Интеграция системы управления версиями не поддерживается.
• Пользовательские пакеты для Python 3.10 (предварительная версия) проверяются только во время выполнения задания. Ожидается, что задание завершится ошибкой, если пакет несовместим в среде выполнения или если необходимые зависимости пакетов не импортируются в учетную запись службы автоматизации.
• В настоящее время модули Runbook Python 3.10 (предварительная версия) поддерживаются только из портал Azure. REST API и PowerShell не поддерживаются.

• Требуется знание скриптов Python.
• Интеграция системы управления версиями не поддерживается.
• Для модулей Python 3.8 используйте файлы колес, предназначенные для cp38-amd64.
• Чтобы использовать библиотеки сторонних производителей, вы должны импортировать пакет в учетную запись службы автоматизации.
• Использование командлета Start-AutomationRunbook в рабочем процессе PowerShell или PowerShell для запуска модуля Runbook Python 3.8 не работает. Командлет Start-AzAutomationRunbook можно использовать из модуля Az.Automation или командлета Start-AzureRmAutomationRunbook из модуля AzureRm.Automation, чтобы обойти это ограничение. 
• служба автоматизации Azure не поддерживает sys.stderr.
• Пакет автоматизации Python недоступен в pypi.org, поэтому он недоступен для импорта на компьютер Windows.

• Python 2.7 больше не поддерживается родительским продуктом Python. Мы рекомендуем создать новые модули Runbook в поддерживаемых версиях и обновить устаревшие модули Runbook.
• Требуется знание скриптов Python.
• Для модулей Python 2.7.12 используйте файлы колеса cp27-amd6.
• Чтобы использовать библиотеки сторонних производителей, вы должны импортировать пакет в учетную запись службы автоматизации.
• служба автоматизации Azure не поддерживает sys.stderr.
• Пакет автоматизации Python недоступен в pypi.org, поэтому он недоступен для импорта на компьютер Windows.