AzurePowerShell@3 – Azure PowerShell v3-uppgift

Använd den här uppgiften för att köra ett PowerShell-skript i en Azure-miljö. Azure-kontexten autentiseras med den tillhandahållna Azure Resource Manager-tjänstanslutningen.

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.

Indata

azureConnectionType - Azure-anslutningstyp
Indataalias: ConnectedServiceNameSelector. string. Tillåtna värden: ConnectedServiceName (klassisk Azure), ConnectedServiceNameARM (Azure Resource Manager). Standardvärde: ConnectedServiceNameARM.

azureClassicSubscription - Klassisk Azure-prenumeration
Indataalias: ConnectedServiceName. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceName.

Den klassiska Azure-prenumerationen som ska konfigureras innan du kör PowerShell.

azureSubscription - Azure-prenumeration
Indataalias: ConnectedServiceNameARM. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceNameARM.

Azure Resource Manager-prenumerationen som ska konfigureras innan du kör PowerShell.

ScriptType - Skripttyp
string. Tillåtna värden: FilePath (Skriptfilsökväg), InlineScript (infogat skript). Standardvärde: FilePath.

Typ av skript: filsökväg eller infogad.

ScriptPath - Skriptsökväg
string. Valfritt. Använd när ScriptType = FilePath.

Sökvägen till skriptet. Detta bör vara en fullständigt kvalificerad sökväg eller en i förhållande till standardarbetskatalogen.

Inline - Infogat skript
string. Valfritt. Använd när ScriptType = InlineScript. Standardvärde: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Anger vilket skript som ska köras. Den maximala längden på infogade skript som stöds är 5 000 tecken. Använd ett skript från en fil om du vill använda ett längre skript.

ScriptArguments - Skriptargument
string. Valfritt. Använd när ScriptType = FilePath.

De ytterligare parametrar som ska skickas till PowerShell. Dessa kan vara antingen ordningstal eller namngivna parametrar.

errorActionPreference - ErrorActionPreference
string. Tillåtna värden: stop, continue, silentlyContinue. Standardvärde: stop.

Väljer värdet för variabeln ErrorActionPreference för körning av skriptet.

FailOnStandardError - Fel vid standardfel
boolean. Standardvärde: false.

När detta är sant misslyckas den här aktiviteten om några fel skrivs till felpipelinen eller om några data skrivs till standardfelströmmen.

azurePowerShellVersion - Azure PowerShell version
Indataalias: TargetAzurePs. string. Tillåtna värden: LatestVersion (Senaste installerade versionen) OtherVersion (Ange annan version). Standardvärde: OtherVersion.

För värdbaserade agenter är 2.1.0de Azure PowerShell versioner som stöds , 3.8.0, 4.2.15.1.1 och 6.7.0. Om du vill välja den senaste versionen som är tillgänglig för agenten väljer du LatestVersion (Senaste installerade versionen).

För privata agenter kan du ange en önskad version av Azure PowerShell med (OtherVersionAnge annan version).

preferredAzurePowerShellVersion - Önskad Azure PowerShell version
Indataalias: CustomTargetAzurePs. string. Krävs när TargetAzurePs = OtherVersion.

Den föredragna Azure PowerShell versionen måste vara en korrekt semantisk version t.ex. 1.2.3.. Regex like 2.\*,2.3.\* stöds inte. Värdbaserade agenter stöder för närvarande Azure-modulversioner, , och AzureRM-modulversioner 2.1.0, 3.8.0, 4.2.1, 5.1.1, 6.7.0. 5.1.14.2.13.8.02.1.0

validateScriptSignature - Verifiera skriptsignatur
boolean. Valfritt. Använd när ScriptType = FilePath. Standardvärde: false.

Om detta är sant kontrollerar aktiviteten först att det angivna skriptet är signerat och giltigt innan det körs.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Stöd har lagts till för Fel vid standardfel och ErrorActionPreference.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: azureps
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	2.0.0 eller senare
Uppgiftskategori	Distribuera