AzurePowerShell@2 – úloha Azure PowerShell v2

Článek
07/02/2024

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 v2
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@2
  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'. 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. 
    #azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
    preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.

Vstupy

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

azureClassicSubscription - Předplatné Azure Classic
Alias vstupu: 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
Alias vstupu: 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. Povinná hodnota. 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.

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

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ů jsou 2.1.0podporované verze Azure PowerShell , 3.8.04.2.1, 5.1.1 a 6.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 (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í agenti v současné době podporují verze 2.1.0modulů Azure , 3.8.0, , 4.2.15.1.1 a verze modulů 2.1.0AzureRM , 3.8.0, , 4.2.1, . 6.7.05.1.1

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é

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	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	1.95.0 nebo vyšší
Kategorie úloh	Nasazení

Sdílet prostřednictvím