AzurePowerShell@4 – úloha Azure PowerShell v4

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

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.

Vstupy

azureSubscription - Předplatné Azure
Alias vstupu: ConnectedServiceNameARM. string. Povinná hodnota.

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 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 5 000 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 předávají do PowerShellu. Můžou být buď ř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 se do kanálu chyb zapíšou nějaké chyby nebo pokud se do standardního datového proudu chyb zapíšou nějaká data.

RestrictContextToCurrentTask - Omezení rozsahu kontextu na aktuální úkol
boolean. Výchozí hodnota: false.

Pokud je to pravda, omezí tato úloha rozsah kontextu pouze na aktuální úlohu a kontext nebude k dispozici pro jiné úlohy v kanálu při použití privátního agenta.

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

V případě hostovaných agentů je podporovaná verze Azure PowerShell: 1.0.0 (hostovaná fronta VS2017). 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 (Zadejte jinou verzi).

preferredAzurePowerShellVersion - Upřednostňovaná verze Azure PowerShell
Alias vstupu: 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. Regulární výraz like 2.\*,2.3.\* se nepodporuje. Hostovaný fond VS2017 aktuálně podporuje verzi modulu Az. 1.0.0.

pwsh - Použití PowerShellu Core
boolean. Výchozí hodnota: false.

Pokud je to pravda, pak ve Windows použije pwsh.exe úloha z vaší cesty místo powershell.exe.

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

workingDirectory - Pracovní adresář
string.

Pracovní adresář, ve kterém je skript spuštěn.

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ích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Přidání podpory pro modul Az a agenty pro různé platformy

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
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.115.0 nebo vyšší
Kategorie úloh	Nasazení