AzurePowerShell@4 - Azure PowerShell tarefa v4
Utilize esta tarefa para executar um script do PowerShell num ambiente do Azure. O contexto do Azure é autenticado com a ligação de serviço do Azure Resource Manager fornecida.
Syntax
# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
inputs:
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. 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.
#RestrictContextToCurrentTask: false # boolean. Restrict scope of context to current task. 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
#pwsh: false # boolean. Use PowerShell Core. Default: false.
#validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.
#workingDirectory: # string. Working Directory.
# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
inputs:
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. 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.
#RestrictContextToCurrentTask: false # boolean. Restrict scope of context to current task. 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
#pwsh: false # boolean. Use PowerShell Core. Default: false.
#workingDirectory: # string. Working Directory.
# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
inputs:
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. 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
#pwsh: false # boolean. Use PowerShell Core. Default: false.
#workingDirectory: # string. Working Directory.
# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
inputs:
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. 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.
Entradas
azureSubscription
- Subscrição do Azure
Alias de entrada: ConnectedServiceNameARM
. string
. Obrigatório.
O Azure Resource Manager subscrição a configurar antes de executar o PowerShell.
ScriptType
- Tipo de Script
string
. Valores permitidos: FilePath
(Caminho do Ficheiro de Script), InlineScript
(Script Inline). Valor predefinido: FilePath
.
O tipo do script: caminho do ficheiro ou inline.
ScriptPath
- Caminho do Script
string
. Opcional. Utilize quando ScriptType = FilePath
.
O caminho do script. Este deve ser um caminho completamente qualificado ou um relativo ao diretório de trabalho predefinido.
Inline
- Inline Script
string
. Opcional. Utilize quando ScriptType = InlineScript
. Valor predefinido: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments
.
Especifica o script a executar. O comprimento máximo do script inline suportado é de 5000 carateres. Utilize um script de um ficheiro se quiser utilizar um script mais longo.
ScriptArguments
- Argumentos de Script
string
. Opcional. Utilize quando ScriptType = FilePath
.
Os parâmetros adicionais a transmitir para o PowerShell. Podem ser parâmetros ordinais ou nomeados.
errorActionPreference
- ErrorActionPreference
string
. Valores permitidos: stop
, , continue
silentlyContinue
. Valor predefinido: stop
.
Seleciona o valor da ErrorActionPreference
variável para executar o script.
FailOnStandardError
- Falha no Erro Padrão
boolean
. Valor predefinido: false
.
Quando isto for verdadeiro, esta tarefa falhará se forem escritos erros no pipeline de erros ou se forem escritos dados no fluxo de erros padrão.
RestrictContextToCurrentTask
- Restringir o âmbito do contexto à tarefa atual
boolean
. Valor predefinido: false
.
Quando isto for verdadeiro, esta tarefa irá restringir o âmbito de contexto apenas à tarefa atual e o contexto não estará disponível para outras tarefas no pipeline ao utilizar um agente privado.
azurePowerShellVersion
- Versão do Azure PowerShell
Alias de entrada: TargetAzurePs
. string
. Valores permitidos: LatestVersion
(Versão instalada mais recente), OtherVersion
(Especifique outra versão). Valor predefinido: OtherVersion
.
No caso dos agentes alojados, a Versão de Azure PowerShell suportada é: 1.0.0
(Fila VS2017 Alojada).
Para escolher a versão mais recente disponível no agente, selecione LatestVersion
(Versão instalada mais recente).
Para agentes privados, pode especificar uma versão preferencial do Azure PowerShell com OtherVersion
(Especificar outra versão).
preferredAzurePowerShellVersion
- Versão de Azure PowerShell Preferencial
Alias de entrada: CustomTargetAzurePs
. string
. Necessário quando TargetAzurePs = OtherVersion
.
A Versão de Azure PowerShell preferencial tem de ser uma versão semântica adequada, por exemplo. 1.2.3.
Regex like 2.\*,2.3.\*
não é suportado. O Conjunto de VS2017 Alojado suporta atualmente a versão do módulo Az 1.0.0.
pwsh
- Utilizar o PowerShell Core
boolean
. Valor predefinido: false
.
Se for verdade, no Windows, a tarefa será utilizada pwsh.exe
a partir do seu caminho em vez de powershell.exe
.
validateScriptSignature
- Validar assinatura de script
boolean
. Opcional. Utilize quando ScriptType = FilePath
. Valor predefinido: false
.
Se for verdade, a tarefa irá primeiro verificar se o script especificado está assinado e é válido antes de executá-lo.
workingDirectory
- Diretório de Trabalho
string
.
O diretório de trabalho onde o script é executado.
Opções de controlo de tarefas
Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Observações
Foi adicionado suporte para o Módulo Az e agentes entre plataformas.
Requisitos
Requisito | Description |
---|---|
Tipos de pipeline | YAML, Compilação clássica, Versão clássica |
É executado em | Agent, DeploymentGroup |
Exigências | Nenhuma |
Capacidades | Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa. |
Restrições de comandos | Qualquer |
Variáveis de definição | Qualquer |
Versão do agente | 2.115.0 ou superior |
Categoria da tarefa | Implementação |