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


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

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

Синтаксис

# Azure PowerShell v3
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@3
  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'. Script Type. Default: FilePath.
    #ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path. 
    #Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script. 
    #ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments. 
    #errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
    #FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
  # Azure PowerShell version options
    #azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
    preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version. 
  # Advanced
    #validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.
# Azure PowerShell v3
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@3
  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'. Script Type. Default: FilePath.
    #ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path. 
    #Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script. 
    #ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments. 
    #errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
    #FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
  # Azure PowerShell version options
    #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. Необязательный элемент. Используйте при ScriptType = FilePath.

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


errorActionPreference - ErrorActionPreference
string. Допустимые значения: stop, continue, silentlyContinue. Значение по умолчанию: stop.

Выбирает значение переменной ErrorActionPreference для выполнения скрипта.


FailOnStandardError - Сбой при стандартной ошибке
boolean. Значение по умолчанию: false.

Если это так, эта задача завершается сбоем, если какие-либо ошибки записываются в конвейер ошибок или если какие-либо данные записываются в стандартный поток ошибок.


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

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

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


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

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


validateScriptSignature - Проверка подписи скрипта
boolean. Необязательный элемент. Используйте при ScriptType = FilePath. Значение по умолчанию: false.

Если это так, задача сначала проверка, чтобы убедиться, что указанный скрипт подписан и действителен перед его выполнением.


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

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

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

Нет.

Remarks

Добавлена поддержка стандартной ошибки Fail on и ErrorActionPreference.

Требования

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