AzurePowerShell@3 — задача Azure PowerShell версии 3
Используйте эту задачу для запуска скрипта PowerShell в среде Azure. Контекст Azure проходит проверку подлинности с помощью предоставленного подключения к службе Azure Resource Manager.
Эта версия задачи устарела; используйте AzurePowerShell@5.
Используйте эту задачу для запуска скрипта 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.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
.
validateScriptSignature
-
Проверка подписи скрипта
boolean
. Необязательно. Используется при ScriptType = FilePath
. Значение по умолчанию: false
.
Если это верно, задача сначала проверяет, подписан ли указанный скрипт и действителен перед его выполнением.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.
Выходные переменные
Нет.
Замечания
Добавлена поддержка ошибки в стандартной ошибке и ErrorActionPreference.
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
требования | Локальные агенты должны иметь возможности , которые соответствуют следующим требованиям требуют выполнения заданий, использующих эту задачу: azureps |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Любое |
переменные settable | Любое |
Версия агента | 2.0.0 или более поздней версии |
Категория задач | Внедрять |