AzurePowerShell@3 - Azure PowerShell v3-taak

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.

Syntaxis

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

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. 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. Facultatief. Gebruiken wanneer ScriptType = FilePath.

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

errorActionPreference - ErrorActionPreference
string. Toegestane waarden: stop, continue, silentlyContinue. Standaardwaarde: stop.

Selecteert de waarde van de ErrorActionPreference variabele voor het uitvoeren van het script.

FailOnStandardError - mislukt bij standaardfout
boolean. Standaardwaarde: false.

Als dit waar is, mislukt deze taak als er fouten naar de foutpijplijn worden geschreven of als er gegevens naar de standaardfoutstroom worden geschreven.

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.

validateScriptSignature - scripthandtekening valideren
boolean. Facultatief. Gebruiken wanneer ScriptType = FilePath. Standaardwaarde: false.

Als dit waar is, controleert de taak eerst of het opgegeven script is ondertekend en geldig is voordat het wordt uitgevoerd.

Opties voor taakbeheer

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

Uitvoervariabelen

Geen.

Opmerkingen

Er is ondersteuning toegevoegd voor fail op standaardfout en ErrorActionPreference.

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	2.0.0 of hoger
Taakcategorie	Implementeren