AzurePowerShell@2 - Azure PowerShell v2-taak

Artikel
03/24/2025

Gebruik deze taak om een PowerShell-script uit te voeren in een Azure-omgeving. De Azure-context wordt geverifieerd met de opgegeven Azure Resource Manager-serviceverbinding.

Deze versie van de taak is afgeschaft; AzurePowerShell@5gebruiken.

Gebruik deze taak om een PowerShell-script uit te voeren in een Azure-omgeving. De Azure-context wordt geverifieerd met de opgegeven Azure Resource Manager-serviceverbinding.

Syntaxis

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

Invoer

azureConnectionType - Azure-verbindingstype
Invoeralias: ConnectedServiceNameSelector. string. Toegestane waarden: ConnectedServiceName (klassiek Azure), ConnectedServiceNameARM (Azure Resource Manager). Standaardwaarde: ConnectedServiceNameARM.

azureClassicSubscription - klassieke Azure-abonnement
Invoeralias: ConnectedServiceName. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName.

Het klassieke Azure-abonnement dat moet worden geconfigureerd voordat u PowerShell uitvoert.

azureSubscription - Azure-abonnement
Invoeralias: ConnectedServiceNameARM. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceNameARM.

Het Azure Resource Manager-abonnement dat u wilt configureren voordat u PowerShell uitvoert.

ScriptType - scripttype
string. Verplicht. Toegestane waarden: FilePath (scriptbestandspad), InlineScript (inlinescript). Standaardwaarde: FilePath.

Het type script: bestandspad of inline.

ScriptPath - scriptpad
string. Facultatief. Gebruiken wanneer ScriptType = FilePath.

Het pad van het script. Dit moet een volledig gekwalificeerd pad zijn of één ten opzichte van de standaardwerkmap.

Inline - inlinescript
string. Facultatief. Gebruiken wanneer ScriptType = InlineScript. Standaardwaarde: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Hiermee wordt het script opgegeven dat moet worden uitgevoerd. De maximale ondersteunde lengte van inlinescripts is 5000 tekens. Gebruik een script uit een bestand als u een langer script wilt gebruiken.

ScriptArguments - scriptargumenten
string.

De aanvullende parameters die moeten worden doorgegeven aan PowerShell. Dit kunnen ordinale of benoemde parameters zijn.

azurePowerShellVersion - Azure PowerShell-versie
Invoeralias: TargetAzurePs. string. Toegestane waarden: LatestVersion (meest recente geïnstalleerde versie), OtherVersion (geef een andere versie op). Standaardwaarde: OtherVersion.

In het geval van gehoste agents zijn de ondersteunde Azure PowerShell-versies 2.1.0, 3.8.0, 4.2.1, 5.1.1 en 6.7.0. Als u de meest recente versie wilt kiezen die beschikbaar is op de agent, selecteert u LatestVersion (meest recente geïnstalleerde versie).

Voor privéagents kunt u een voorkeursversie van Azure PowerShell opgeven met behulp van OtherVersion (geef een andere versie op).

preferredAzurePowerShellVersion - voorkeursversie van Azure PowerShell
Invoeralias: CustomTargetAzurePs. string. Vereist wanneer TargetAzurePs = OtherVersion.

De voorkeursversie van Azure PowerShell moet een juiste semantische versie zijn, bijvoorbeeld. 1.2.3.. Regex zoals 2.\*,2.3.\* wordt niet ondersteund. Gehoste agents ondersteunen momenteel versies van Azure-modules 2.1.0, 3.8.0, 4.2.1, 5.1.1 en AzureRM-moduleversies 2.1.0, 3.8.0, 4.2.1, 5.1.1, 6.7.0.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen om taken uit te voeren die gebruikmaken van deze taak: azureps:
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.95.0 of hoger
Taakcategorie	Implementeren

Delen via