Partilhar via


AzurePowerShell@1 - tarefa Azure PowerShell v1

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 v1
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    #ConnectedServiceNameARM: # string. 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.

Entradas

ConnectedServiceNameSelector - Tipo de Ligação do Azure
string. Valores permitidos: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Valor predefinido: ConnectedServiceName.


ConnectedServiceName - Subscrição Clássica do Azure
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.

A subscrição clássica do Azure para configurar antes de executar o PowerShell.


ConnectedServiceNameARM - Subscrição do Azure
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

A subscrição do Azure Resource Manager para configurar antes de executar o PowerShell.


ScriptType - Tipo de Script
string. Obrigatório. 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 500 carateres. Utilize um script de um ficheiro se quiser utilizar um script mais longo.


ScriptArguments - Argumentos de Script
string.

Os parâmetros adicionais a transmitir para o PowerShell. Estes podem ser parâmetros ordinais ou nomeados.


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.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agente, DeploymentGroup
Exigências Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizam esta tarefa: azureps
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de tabelas definidas Qualquer
Versão do agente 1.95.0 ou superior
Categoria da tarefa Implementação