Sdílet prostřednictvím

AzurePowerShell@2 – úloha Azure PowerShellu v2

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

Tato verze úlohy je zastaralá; použít AzurePowerShell@5.

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

Syntaxe

# 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 - typu připojení Azure
Vstupní alias: ConnectedServiceNameSelector. string. Povolené hodnoty: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Výchozí hodnota: ConnectedServiceNameARM.


azureClassicSubscription - předplatného Azure Classic
Vstupní alias: ConnectedServiceName. string. Požadováno při ConnectedServiceNameSelector = ConnectedServiceName.

Před spuštěním PowerShellu nakonfigurujete předplatné Azure Classic.


azureSubscription - předplatného Azure
Vstupní alias: ConnectedServiceNameARM. string. Požadováno při ConnectedServiceNameSelector = ConnectedServiceNameARM.

Před spuštěním PowerShellu nakonfigurujete předplatné Azure Resource Manageru.


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

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


cesta ke skriptu ScriptPath -
string. Volitelný. Používá se při ScriptType = FilePath.

Cesta skriptu. Měla by to být plně kvalifikovaná cesta nebo cesta vzhledem k výchozímu pracovnímu adresáři.


Inline - vložený skript
string. Volitelný. Používá se při 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 mají předat do PowerShellu. Mohou to být buď řadové, nebo pojmenované parametry.


azurePowerShellVersion - verze Azure PowerShellu
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 podporované verze Azure PowerShellu 2.1.0, 3.8.0, 4.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 zadat upřednostňovanou verzi Azure PowerShellu pomocí OtherVersion (zadejte jinou verzi).


preferredAzurePowerShellVersion - upřednostňovanou verzi Azure PowerShellu
Vstupní alias: CustomTargetAzurePs. string. Požadováno při TargetAzurePs = OtherVersion.

Upřednostňovaná verze Azure PowerShellu musí být správná sémantická verze, např. 1.2.3.. Regulární výrazy jako 2.\*,2.3.\* se nepodporují. Hostovaní agenti aktuálně podporují verze modulů Azure 2.1.0, 3.8.0, 4.2.1, 5.1.1 a verze modulů AzureRM 2.1.0, 3.8.0, 4.2.1, 5.1.1, 6.7.0.


Možnosti ovládání úloh

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

Výstupní proměnné

Žádné.

Požadavky

Požadavek Popis
Typy kanálů YAML, klasické sestavení, klasická verze
Běží na Agent, DeploymentGroup
požadavky Agenti v místním prostředí musí mít schopnosti, které odpovídají následujícím požadavkům ke 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ů Jakýkoliv
nastavitelné proměnné Jakýkoliv
Verze agenta 1.95.0 nebo vyšší
Kategorie úkolu Nasadit
  • Last updated on