Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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.
Cette version de la tâche est déconseillée ; utilisez AzurePowerShell@5.
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.
Syntaxe
# 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
-
d’abonnement Azure Classic
Alias d’entrée : ConnectedServiceName
.
string
. Obligatoire lorsque ConnectedServiceNameSelector = ConnectedServiceName
.
Abonnement Azure Classic à configurer avant d’exécuter PowerShell.
azureSubscription
-
abonnement Azure
Alias d’entrée : ConnectedServiceNameARM
.
string
. Obligatoire lorsque ConnectedServiceNameSelector = ConnectedServiceNameARM
.
Abonnement Azure Resource Manager à configurer avant d’exécuter PowerShell.
ScriptType
-
type de script
string
. Obligatoire. Valeurs autorisées : FilePath
(chemin du fichier de script), InlineScript
(script inline). Valeur par défaut : FilePath
.
Type de script : chemin d’accès de fichier ou inline.
ScriptPath
-
chemin d’accès de script
string
. Optionnel. Utilisez quand ScriptType = FilePath
.
Chemin d’accès du script. Il doit s’agir d’un chemin complet ou d’un chemin d’accès par rapport au répertoire de travail par défaut.
Inline
-
script inline
string
. Optionnel. 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
.
Specifes le script à exécuter. La longueur maximale du 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
-
arguments de script
string
.
Paramètres supplémentaires à passer à PowerShell. Il peut s’agir de paramètres ordinaux ou nommés.
azurePowerShellVersion
-
version d’Azure PowerShell
Alias d’entrée : TargetAzurePs
.
string
. Valeurs autorisées : LatestVersion
(dernière version installée), OtherVersion
(Spécifier une autre version). Valeur par défaut : OtherVersion
.
En cas d’agents hébergés, les versions Azure PowerShell prises en charge sont 2.1.0
, 3.8.0
, 4.2.1
, 5.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 d’Azure PowerShell à l’aide de OtherVersion
(spécifier une autre version).
preferredAzurePowerShellVersion
-
version Azure PowerShell préférée
Alias d’entrée : CustomTargetAzurePs
.
string
. Obligatoire lorsque TargetAzurePs = OtherVersion
.
La version Azure PowerShell préférée doit être une version sémantique appropriée, par exemple.
1.2.3.
. Les expressions régulières comme 2.\*,2.3.\*
ne sont pas prises en charge. Les agents hébergés prennent actuellement en charge les versions de module Azure 2.1.0
, 3.8.0
, 4.2.1
, 5.1.1
et les versions de module AzureRM 2.1.0
, 3.8.0
, 4.2.1
, 5.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.
Spécifications
Besoin | Descriptif |
---|---|
Types de pipelines | YAML, Build Classique, Version Classique |
Exécutions sur | Agent, DeploymentGroup |
demandes | Les agents auto-hébergés doivent disposer de fonctionnalités qui correspondent aux exigences de suivantes pour exécuter des travaux qui utilisent cette tâche : azureps |
fonctionnalités de | Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail. |
restrictions de commande | N'importe quel |
variables settables | N'importe quel |
Version de l’agent | 1.95.0 ou version ultérieure |
Catégorie de tâche | Déployer |