AzurePowerShell@4 – Tarefa do Azure PowerShell v4

Use essa tarefa para executar um script do PowerShell em um ambiente do Azure. O contexto do Azure é autenticado com a conexão de serviço Azure Resource Manager fornecida.

# 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.

azureSubscription - assinatura do Azure
Alias de entrada: ConnectedServiceNameARM. string. Obrigatório

A assinatura do Azure Resource Manager a ser configurada antes de executar o PowerShell.

ScriptType - tipo de script
string. Valores permitidos: FilePath (caminho do arquivo de script), InlineScript (script embutido). Valor padrão: FilePath.

O tipo do script: caminho do arquivo ou embutido.

ScriptPath - caminho de script
string. Opcional. Use quando ScriptType = FilePath.

O caminho do script. Esse deve ser um caminho totalmente qualificado ou um relativo ao diretório de trabalho padrão.

Inline - script embutido
string. Opcional. Use quando ScriptType = InlineScript. Valor padrão: # 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 ser executado. O comprimento máximo de script embutido com suporte é de 5.000 caracteres. Use um script de um arquivo se quiser usar um script mais longo.

argumentos de script ScriptArguments -
string. Opcional. Use quando ScriptType = FilePath.

Os parâmetros adicionais a serem passados para o PowerShell. Podem ser parâmetros ordinais ou nomeados.

ErrorActionPreference errorActionPreference -
string. Valores permitidos: stop, continue, silentlyContinue. Valor padrão: stop.

Seleciona o valor da variável ErrorActionPreference para executar o script.

FailOnStandardError - falha no de erro padrão
boolean. Valor padrão: false.

Quando isso for verdadeiro, essa tarefa falhará se algum erro for gravado no pipeline de erros ou se algum dado for gravado no fluxo de erros padrão.

RestrictContextToCurrentTask - Restringir o escopo do contexto à tarefa atual
boolean. Valor padrão: false.

Quando isso for verdadeiro, essa tarefa restringirá o escopo do contexto somente à tarefa atual e o contexto não estará disponível para outras tarefas no pipeline ao usar um agente privado.

azurePowerShellVersion - versão do Azure PowerShell
Alias de entrada: TargetAzurePs. string. Valores permitidos: LatestVersion (versão mais recente instalada), OtherVersion (especificar outra versão). Valor padrão: OtherVersion.

No caso de agentes hospedados, a versão do Azure PowerShell com suporte é: 1.0.0 (Fila VS2017 hospedada). Para escolher a versão mais recente disponível no agente, selecione LatestVersion (versão mais recente instalada).

Para agentes privados, você pode especificar uma versão preferencial do Azure PowerShell usando OtherVersion (especifique outra versão).

preferredAzurePowerShellVersion - versão preferencial do Azure PowerShell
Alias de entrada: CustomTargetAzurePs. string. Necessário quando TargetAzurePs = OtherVersion.

A versão preferencial do Azure PowerShell precisa ser uma versão semântica adequada, por exemplo. não há suporte 1.2.3. Regex como 2.\*,2.3.\*. O Pool vs2017 hospedado atualmente dá suporte à versão do módulo Az 1.0.0.

pwsh - usar o PowerShell Core
boolean. Valor padrão: false.

Se isso for verdadeiro, no Windows, a tarefa usará pwsh.exe do seu caminho em vez de powershell.exe.

validateScriptSignature - Validar de assinatura de script
boolean. Opcional. Use quando ScriptType = FilePath. Valor padrão: false.

Se isso for verdadeiro, a tarefa primeiro verificará se o script especificado está assinado e válido antes de executá-lo.

do Diretório de Trabalho do workingDirectory -
string.

O diretório de trabalho em que o script é executado.

Nenhum.