AzurePowerShell@2 — задача Azure PowerShell версии 2
Используйте эту задачу для запуска скрипта PowerShell в среде Azure. Контекст Azure проходит проверку подлинности с помощью предоставленного подключения службы azure Resource Manager.
Синтаксис
# 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.
. Регулярное выражение типа 2.\*,2.3.\*
не поддерживается. Размещенные агенты в настоящее время поддерживают версии 2.1.0
модулей Azure , 3.8.0
, 5.1.1
4.2.1
и AzureRM2.1.0
, , 3.8.0
, 4.2.1
5.1.1
6.7.0
, .
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.
Выходные переменные
Нет.
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
Требования | Локальные агенты должны иметь возможности , соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: azureps |
Capabilities | Эта задача не удовлетворяет требованиям для последующих задач в задании. |
Ограничения команд | Любой |
Устанавливаемые переменные | Любой |
Версия агента | 1.95.0 или более поздней версии |
Категория задач | Развертывание |