Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Eingänge
ConnectedServiceNameSelector
-
Azure-Verbindungstyp
string. Zulässige Werte: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Standardwert: ConnectedServiceName.
ConnectedServiceName
-
azure Classic-Abonnement
string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName.
Das zu konfigurierende Azure Classic-Abonnement, bevor PowerShell ausgeführt wird.
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. Wahlfrei. Wird verwendet, wenn ScriptType = FilePath.
Der Pfad des Skripts. Dies sollte ein vollqualifizierter Pfad oder ein pfad relativ zum Standardarbeitsverzeichnis sein.
Inline
-
Inlineskript-
string. Wahlfrei. Wird verwendet, 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 um Ordinal- oder benannte Parameter handelt.
Aufgabensteuerungsoptionen
Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.
Ausgabevariablen
Keiner.
Anforderungen
| Anforderung | BESCHREIBUNG |
|---|---|
| Pipelinetypen | YAML, Classic Build, Classic Release |
| Läuft auf | Agent, DeploymentGroup |
| Anforderungen | Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: azureps: |
| Funktionen | Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag. |
| Befehlseinschränkungen | Jegliche |
| Settable-Variablen | Jegliche |
| Agentversion | 1.95.0 oder höher |
| Vorgangskategorie | Einsetzen |