AzurePowerShell@1 – Azure PowerShell v1-Aufgabe

Artikel
07/02/2024

Verwenden Sie diese Aufgabe, um ein PowerShell-Skript in einer Azure-Umgebung auszuführen. Der Azure-Kontext wird mit der bereitgestellten Azure Resource Manager-Dienstverbindung authentifiziert.

Syntax

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

Eingaben

ConnectedServiceNameSelector - Azure-Verbindungstyp
string. Zulässige Werte: ConnectedServiceName (klassische Azure), ConnectedServiceNameARM (Azure Resource Manager). Standardwert. ConnectedServiceName.

ConnectedServiceName - Klassisches Azure-Abonnement
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName.

Das klassische Azure-Abonnement, das vor der Ausführung von PowerShell konfiguriert werden soll.

ConnectedServiceNameARM - Azure-Abonnement
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceNameARM.

Das Azure Resource Manager Abonnement, das vor der Ausführung von PowerShell konfiguriert werden soll.

ScriptType - Skripttyp
string. Erforderlich. Zulässige Werte: FilePath (Skriptdateipfad), InlineScript (Inlineskript). Standardwert. FilePath.

Der Typ des Skripts: Dateipfad oder Inline.

ScriptPath - Skriptpfad
string. Optional. Verwenden Sie , wenn ScriptType = FilePath.

Der Pfad des Skripts. Dies sollte ein vollqualifizierter Pfad oder ein pfad relativ zum Standardarbeitsverzeichnis sein.

Inline - Inlineskript
string. Optional. Verwenden Sie , wenn ScriptType = InlineScript. Standardwert. # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Gibt das auszuführende Skript an. Die maximal unterstützte Inlineskriptlänge beträgt 500 Zeichen. Verwenden Sie ein Skript aus einer Datei, wenn Sie ein längeres Skript verwenden möchten.

ScriptArguments - Skriptargumente
string.

Die zusätzlichen Parameter, die an PowerShell übergeben werden sollen. Dabei kann es sich entweder um Ordnungsparameter oder um benannte Parameter handelt.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: azureps
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	1.95.0 oder höher
Aufgabenkategorie	Bereitstellen

Freigeben über