AzurePowerShell@4 – Azure PowerShell v4-Aufgabe

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.

# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. 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.
    #RestrictContextToCurrentTask: false # boolean. Restrict scope of context to current task. 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
    #pwsh: false # boolean. Use PowerShell Core. Default: false.
    #validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.
    #workingDirectory: # string. Working Directory.

# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. 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.
    #RestrictContextToCurrentTask: false # boolean. Restrict scope of context to current task. 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
    #pwsh: false # boolean. Use PowerShell Core. Default: false.
    #workingDirectory: # string. Working Directory.

azureSubscription - Azure-Abonnement-
Eingabealias: ConnectedServiceNameARM. string. Erforderlich.

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

ScriptType - Skripttyp-
string. 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 5000 Zeichen. Verwenden Sie ein Skript aus einer Datei, wenn Sie ein längeres Skript verwenden möchten.

ScriptArguments - Skriptargumente
string. Wahlfrei. Wird verwendet, wenn ScriptType = FilePath.

Die zusätzlichen Parameter, die an PowerShell übergeben werden sollen. Kann entweder Ordinal- oder benannte Parameter sein.

errorActionPreference - ErrorActionPreference-
string. Zulässige Werte: stop, continue, silentlyContinue. Standardwert: stop.

Wählt den Wert der ErrorActionPreference Variablen zum Ausführen des Skripts aus.

FailOnStandardError - fehler bei Standardfehler-
boolean. Standardwert: false.

Wenn dies zutrifft, schlägt diese Aufgabe fehl, wenn Fehler in die Fehlerpipeline geschrieben werden oder daten in den Standardfehlerdatenstrom geschrieben werden.

RestrictContextToCurrentTask - Einschränken des Kontextbereichs auf aktuelle Vorgangs-
boolean. Standardwert: false.

Wenn dies zutrifft, schränkt diese Aufgabe den Kontext nur auf die aktuelle Aufgabe ein, und der Kontext steht anderen Aufgaben in der Pipeline bei Verwendung eines privaten Agents nicht zur Verfügung.

azurePowerShellVersion - Azure PowerShell-Version
Eingabealias: TargetAzurePs. string. Zulässige Werte: LatestVersion (neueste installierte Version), OtherVersion (Andere Version angeben). Standardwert: OtherVersion.

Bei gehosteten Agents lautet die unterstützte Azure PowerShell-Version: 1.0.0 (gehostete VS2017-Warteschlange). Um die neueste version auszuwählen, die für den Agent verfügbar ist, wählen Sie LatestVersion (neueste installierte Version) aus.

Für private Agents können Sie eine bevorzugte Version von Azure PowerShell mithilfe von OtherVersion angeben (Andere Version angeben).

preferredAzurePowerShellVersion - bevorzugte Azure PowerShell-Version
Eingabealias: CustomTargetAzurePs. string. Erforderlich, wenn TargetAzurePs = OtherVersion.

Die bevorzugte Azure PowerShell-Version muss z. B. eine richtige semantische Version sein. 1.2.3. Regex wie 2.\*,2.3.\* wird nicht unterstützt. Der gehostete VS2017-Pool unterstützt derzeit Az-Modulversion 1.0.0.

pwsh - Verwenden von PowerShell Core-
boolean. Standardwert: false.

Wenn dies zutrifft, verwendet die Aufgabe unter Windows pwsh.exe aus Ihrem Pfad anstelle von powershell.exe.

validateScriptSignature - Überprüfen der Skriptsignatur
boolean. Wahlfrei. Wird verwendet, wenn ScriptType = FilePath. Standardwert: false.

Wenn dies zutrifft, überprüft die Aufgabe zunächst, ob das angegebene Skript signiert und gültig ist, bevor es ausgeführt wird.

workingDirectory - Arbeitsverzeichnis-
string.

Das Arbeitsverzeichnis, in dem das Skript ausgeführt wird.

Keiner.