AzurePowerShell@2 - tâche Azure PowerShell v2

Article
07/02/2024

Utilisez cette tâche pour exécuter un script PowerShell dans un environnement Azure. Le contexte Azure est authentifié avec la connexion de service Azure Resource Manager fournie.

Syntax

# Azure PowerShell v2
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@2
  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'. 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. 
    #azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
    preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.

Entrées

azureConnectionType - Type de connexion Azure
Alias d’entrée : ConnectedServiceNameSelector. string. Valeurs autorisées : ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Valeur par défaut : ConnectedServiceNameARM.

azureClassicSubscription - Abonnement Azure Classic
Alias d’entrée : ConnectedServiceName. string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceName.

Abonnement Azure Classic à configurer avant d’exécuter PowerShell.

azureSubscription - Abonnement Azure
Alias d’entrée : ConnectedServiceNameARM. string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceNameARM.

L’abonnement Azure Resource Manager à configurer avant d’exécuter PowerShell.

ScriptType - Script Type
string. Obligatoire. Valeurs autorisées : FilePath (Chemin du fichier de script), InlineScript (script inline). Valeur par défaut : FilePath.

Type de script : chemin de fichier ou inline.

ScriptPath - Chemin d’accès du script
string. facultatif. Utilisez quand ScriptType = FilePath.

Chemin d’accès du script. Il doit s’agir d’un chemin d’accès complet ou d’un chemin d’accès relatif au répertoire de travail par défaut.

Inline - Inline Script
string. facultatif. Utilisez quand ScriptType = InlineScript. Valeur par défaut : # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Spécifie le script à exécuter. La longueur maximale de script inline prise en charge est de 5 000 caractères. Utilisez un script à partir d’un fichier si vous souhaitez utiliser un script plus long.

ScriptArguments - Script Arguments
string.

Paramètres supplémentaires à passer à PowerShell. Il peut s’agir de paramètres ordinaux ou nommés.

azurePowerShellVersion - version Azure PowerShell
Alias d’entrée : TargetAzurePs. string. Valeurs autorisées : LatestVersion (Dernière version installée), OtherVersion (Spécifiez une autre version). Valeur par défaut : OtherVersion.

Dans le cas d’agents hébergés, les versions Azure PowerShell prises en charge sont 2.1.0, 3.8.0, 4.2.15.1.1 et 6.7.0. Pour sélectionner la dernière version disponible sur l’agent, sélectionnez LatestVersion (Dernière version installée).

Pour les agents privés, vous pouvez spécifier une version préférée de Azure PowerShell à l’aide OtherVersion de (Spécifier une autre version).

preferredAzurePowerShellVersion - Version Azure PowerShell préférée
Alias d’entrée : CustomTargetAzurePs. string. Nécessaire lorsque TargetAzurePs = OtherVersion.

La version Azure PowerShell par défaut doit être une version sémantique appropriée, par exemple. 1.2.3.. L’expression régulière comme 2.\*,2.3.\* n’est pas prise en charge. Les agents hébergés prennent actuellement en charge les versions 2.1.0de module Azure , 3.8.0, 4.2.1et 5.1.1 les versions 2.1.0de module AzureRM , 3.8.0, , 4.2.15.1.1, 6.7.0.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : azureps
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	1.95.0 ou version ultérieure
Catégorie de la tâche	Déployer

Partager via