AzurePowerShell@2 – Azure PowerShell v2-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 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.
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-prenumeration som ska konfigureras innan du kör PowerShell.
ScriptType
- Skripttyp
string
. Krävs. 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 för 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
.
De ytterligare parametrar som ska skickas till PowerShell. Dessa kan vara antingen ordningstal eller namngivna parametrar.
azurePowerShellVersion
- Azure PowerShell version
Indataalias: TargetAzurePs
. string
. Tillåtna värden: LatestVersion
(senaste installerade versionen) OtherVersion
(Ange annan version). Standardvärde: OtherVersion
.
När det gäller värdbaserade agenter är 2.1.0
de Azure PowerShell versioner som stöds , 3.8.0
, 4.2.1
och 5.1.1
6.7.0
.
Välj den senaste versionen som är tillgänglig i agenten genom att välja LatestVersion
(Senaste installerade versionen).
För privata agenter kan du ange en önskad version av Azure PowerShell med (OtherVersion
Ange annan version).
preferredAzurePowerShellVersion
- Önskad Azure PowerShell version
Indataalias: CustomTargetAzurePs
. string
. Krävs när TargetAzurePs = OtherVersion
.
Den föredragna Azure PowerShell version måste vara en korrekt semantisk version t.ex. 1.2.3.
. Regex liknande 2.\*,2.3.\*
stöds inte. Värdbaserade agenter stöder för närvarande Azure-modulversioner 2.1.0
, 3.8.0
, 4.2.1
5.1.1
och AzureRM-modulversioner 2.1.0
, 3.8.0
, 4.2.1
, 5.1.1
, . 6.7.0
Kontrollalternativ för aktivitet
Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.
Utdatavariabler
Inga.
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 | 1.95.0 eller senare |
Uppgiftskategori | Distribuera |