AzurePowerShell@1 - Azure PowerShell v1-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.

Syntaxis

# Azure PowerShell v1
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    #ConnectedServiceNameARM: # string. 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.

Invoer

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

ConnectedServiceName - klassieke Azure-abonnement
string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName.

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

ConnectedServiceNameARM - Azure-abonnement
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 500 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.

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