AzurePowerShell@3 – úloha Azure PowerShell v3

Tuto úlohu použijte ke spuštění skriptu PowerShellu v prostředí Azure. Kontext Azure se ověřuje pomocí zadaného připojení služby Azure Resource Manager.

Syntax

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

Vstupy

azureConnectionType - Typ připojení Azure
Vstupní alias: ConnectedServiceNameSelector. string. Povolené hodnoty: ConnectedServiceName (Azure Classic) ConnectedServiceNameARM (Azure Resource Manager). Výchozí hodnota: ConnectedServiceNameARM.

azureClassicSubscription - Předplatné Azure Classic
Vstupní alias: ConnectedServiceName. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName.

Předplatné Azure Classic, které se má nakonfigurovat před spuštěním PowerShellu.

azureSubscription - Předplatné Azure
Vstupní alias: ConnectedServiceNameARM. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceNameARM.

Azure Resource Manager předplatné, které se má nakonfigurovat před spuštěním PowerShellu.

ScriptType - Typ skriptu
string. Povolené hodnoty: FilePath (cesta k souboru skriptu), InlineScript (vložený skript). Výchozí hodnota: FilePath.

Typ skriptu: cesta k souboru nebo vložená.

ScriptPath - Cesta ke skriptu
string. Nepovinný parametr. Použijte, když ScriptType = FilePath.

Cesta ke skriptu. Mělo by se jednat o plně kvalifikovanou cestu nebo cestu relativní k výchozímu pracovnímu adresáři.

Inline - Vložený skript
string. Nepovinný parametr. Použijte, když ScriptType = InlineScript. Výchozí hodnota: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Specifikuje skript, který se má spustit. Maximální podporovaná délka vloženého skriptu je 5000 znaků. Pokud chcete použít delší skript, použijte skript ze souboru.

ScriptArguments - Argumenty skriptu
string. Nepovinný parametr. Použijte, když ScriptType = FilePath.

Další parametry, které se mají předat do PowerShellu. Můžou to být řadové nebo pojmenované parametry.

errorActionPreference - ErrorActionPreference
string. Povolené hodnoty: stop, continue, silentlyContinue. Výchozí hodnota: stop.

Vybere hodnotu ErrorActionPreference proměnné pro spuštění skriptu.

FailOnStandardError - Selhání při standardní chybě
boolean. Výchozí hodnota: false.

Pokud je to pravda, tato úloha selže, pokud jsou do kanálu chyb zapsány nějaké chyby nebo pokud jsou do standardního datového proudu chyb zapsána nějaká data.

azurePowerShellVersion - verze Azure PowerShell
Vstupní alias: TargetAzurePs. string. Povolené hodnoty: LatestVersion (Nejnovější nainstalovaná verze) OtherVersion (Zadejte jinou verzi). Výchozí hodnota: OtherVersion.

V případě hostovaných agentů jsou 2.1.0podporované verze Azure PowerShell , 3.8.04.2.1a 5.1.16.7.0. Pokud chcete vybrat nejnovější verzi dostupnou v agentu, vyberte LatestVersion (Nejnovější nainstalovaná verze).

U privátních agentů můžete určit upřednostňovanou verzi Azure PowerShell pomocí OtherVersion příkazu (Zadejte jinou verzi).

preferredAzurePowerShellVersion - Upřednostňovaná verze Azure PowerShell
Vstupní alias: CustomTargetAzurePs. string. Vyžaduje se, když TargetAzurePs = OtherVersion.

Upřednostňovanou Azure PowerShell Verze musí být správná sémantická verze např. 1.2.3.. Regex like 2.\*,2.3.\* se nepodporuje. Hostovaní agenti v současné době podporují verze 2.1.0modulů Azure , 3.8.0, 4.2.1a 5.1.1 verze 2.1.0modulů AzureRM , 3.8.0, 4.2.1, 5.1.1, . 6.7.0

validateScriptSignature - Ověření podpisu skriptu
boolean. Nepovinný parametr. Použijte, když ScriptType = FilePath. Výchozí hodnota: false.

Pokud je to pravda, úloha před jeho spuštěním nejprve zkontroluje, jestli je zadaný skript podepsaný a platný.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Přidání podpory pro selhání při standardní chybě a ErrorActionPreference

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na spouštění úloh, které používají tuto úlohu: azureps
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	2.0.0 nebo vyšší
Kategorie úloh	Nasazení