AzurePowerShell@2 — задача Azure PowerShell версии 2

Статья
03/24/2025

Используйте эту задачу для запуска скрипта PowerShell в среде Azure. Контекст Azure проходит проверку подлинности с помощью предоставленного подключения к службе Azure Resource Manager.

Эта версия задачи устарела; используйте AzurePowerShell@5.

Синтаксис

# Azure PowerShell v2
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@2
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Required. Script Type. Default: FilePath.
    #ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path. 
    #Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script. 
    #ScriptArguments: # string. Script Arguments. 
    #azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
    preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.

Входные данные

azureConnectionType - тип подключения Azure
Псевдоним ввода: ConnectedServiceNameSelector. string. Допустимые значения: ConnectedServiceName (классическая модель Azure), ConnectedServiceNameARM (Azure Resource Manager). Значение по умолчанию: ConnectedServiceNameARM.

azureClassicSubscription - классической подписке Azure
Псевдоним ввода: ConnectedServiceName. string. Требуется, если ConnectedServiceNameSelector = ConnectedServiceName.

Классическая подписка Azure, настроенная перед запуском PowerShell.

azureSubscription - подписке Azure
Псевдоним ввода: ConnectedServiceNameARM. string. Требуется, если ConnectedServiceNameSelector = ConnectedServiceNameARM.

Подписка Azure Resource Manager, настроенная перед запуском PowerShell.

типа скрипта ScriptType -
string. Обязательное. Допустимые значения: FilePath (путь к файлу скрипта), InlineScript (встроенный скрипт). Значение по умолчанию: FilePath.

Тип скрипта: путь к файлу или встроенный.

Путьк скрипту ScriptPath -
string. Необязательно. Используется при ScriptType = FilePath.

Путь к скрипту. Это должен быть полный путь или один относительно рабочего каталога по умолчанию.

Inline - встроенный скрипт
string. Необязательно. Используется при ScriptType = InlineScript. Значение по умолчанию: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Спецификация выполняемого скрипта. Максимальная поддерживаемая длина встроенного скрипта составляет 5000 символов. Используйте скрипт из файла, если вы хотите использовать более длинный скрипт.

Аргументы скрипта ScriptArguments -
string.

Дополнительные параметры для передачи в PowerShell. Это могут быть порядковые или именованные параметры.

azurePowerShellVersion - версии Azure PowerShell
Псевдоним ввода: TargetAzurePs. string. Допустимые значения: LatestVersion (последняя установленная версия), OtherVersion (укажите другую версию). Значение по умолчанию: OtherVersion.

В случае размещенных агентов поддерживаемые версии Azure PowerShell 2.1.0, 3.8.0, 4.2.1, 5.1.1 и 6.7.0. Чтобы выбрать последнюю версию агента, выберите LatestVersion (последняя установленная версия).

Для частных агентов можно указать предпочтительную версию Azure PowerShell с помощью OtherVersion (указать другую версию).

preferredAzurePowerShellVersion - предпочтительная версия Azure PowerShell
Псевдоним ввода: CustomTargetAzurePs. string. Требуется, если TargetAzurePs = OtherVersion.

Предпочтительная версия Azure PowerShell должна быть правильной семантической версией, например. 1.2.3.. Regex, например 2.\*,2.3.\*, не поддерживается. Размещенные агенты в настоящее время поддерживают версии модулей Azure 2.1.0, 3.8.0, 4.2.1, 5.1.1 и версий модулей AzureRM 2.1.0, 3.8.0, 4.2.1, 5.1.1, 6.7.0.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Локальные агенты должны иметь возможности , которые соответствуют следующим требованиям требуют выполнения заданий, использующих эту задачу: azureps
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	1.95.0 или более поздней версии
Категория задач	Внедрять

Поделиться через