AzurePowerShell@3 - attività Azure PowerShell v3

Usare questa attività per eseguire uno script di PowerShell all'interno di un ambiente di Azure. Il contesto di Azure viene autenticato con la connessione del servizio azure Resource Manager fornita.

Sintassi

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

Input

azureConnectionType - Tipo di connessione di Azure
Alias di input: ConnectedServiceNameSelector. string. Valori consentiti: ConnectedServiceName (Azure classico), ConnectedServiceNameARM (Resource Manager di Azure). Valore predefinito: ConnectedServiceNameARM.

azureClassicSubscription - Sottoscrizione classica di Azure
Alias di input: ConnectedServiceName. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName.

Sottoscrizione di Azure classica da configurare prima di eseguire PowerShell.

azureSubscription - Sottoscrizione di Azure
Alias di input: ConnectedServiceNameARM. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Sottoscrizione di Azure Resource Manager da configurare prima di eseguire PowerShell.

ScriptType - Tipo di script
string. Valori consentiti: FilePath (Percorso file script), InlineScript (script script script). Valore predefinito: FilePath.

Tipo dello script: percorso file o inline.

ScriptPath - Percorso script
string. Facoltativa. Usare quando ScriptType = FilePath.

Percorso dello script. Questo deve essere un percorso completo o uno relativo alla directory di lavoro predefinita.

Inline - Inline Script
string. Facoltativa. Usare quando ScriptType = InlineScript. Valore predefinito: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Specifica lo script da eseguire. La lunghezza massima supportata dello script inline è di 5000 caratteri. Usare uno script da un file se si vuole usare uno script più lungo.

ScriptArguments - Argomenti script
string. Facoltativa. Usare quando ScriptType = FilePath.

Parametri aggiuntivi da passare a PowerShell. Questi parametri possono essere ordinali o denominati.

errorActionPreference - ErrorActionPreference
string. Valori consentiti: stop, continue, silentlyContinue. Valore predefinito: stop.

Seleziona il valore della variabile per l'esecuzione ErrorActionPreference dello script.

FailOnStandardError - Errore standard non riuscita
boolean. Valore predefinito: false.

Se questa operazione è vera, questa attività avrà esito negativo se eventuali errori vengono scritti nella pipeline di errore o se i dati vengono scritti nel flusso di errori standard.

azurePowerShellVersion - Azure PowerShell versione
Alias di input: TargetAzurePs. string. Valori consentiti: LatestVersion (versione installata più recente), OtherVersion (Specificare un'altra versione). Valore predefinito: OtherVersion.

Nel caso degli agenti ospitati, le versioni supportate di Azure PowerShell sono 2.1.0, 3.8.0, 4.2.15.1.1 e 6.7.0. Per selezionare la versione più recente disponibile nell'agente, selezionare LatestVersion (versione installata più recente).

Per gli agenti privati, è possibile specificare una versione preferita di Azure PowerShell usando OtherVersion (Specificare un'altra versione).

preferredAzurePowerShellVersion - Versione preferita Azure PowerShell
Alias di input: CustomTargetAzurePs. string. Obbligatorio quando TargetAzurePs = OtherVersion.

La versione Azure PowerShell preferita deve essere una versione semantica appropriata, ad esempio. 1.2.3.. Regex come 2.\*,2.3.\* non è supportato. Gli agenti ospitati supportano attualmente le versioni 2.1.0dei moduli di Azure , 3.8.0, 4.2.1e 5.1.1 AzureRM versioni 2.1.0del modulo , 6.7.03.8.04.2.15.1.1.

validateScriptSignature - Convalidare la firma dello script
boolean. Facoltativa. Usare quando ScriptType = FilePath. Valore predefinito: false.

Se è true, l'attività verificherà prima di tutto per assicurarsi che lo script specificato sia firmato e valido prima di eseguirlo.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Aggiunta del supporto per errore standard e ErrorActionPreference.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per l'esecuzione di processi che usano questa attività: azureps
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.0.0 o versione successiva
Categoria attività	Distribuire