AzurePowerShell@2: tarea Azure PowerShell v2

Artículo
07/02/2024

Use esta tarea para ejecutar un script de PowerShell dentro de un entorno de Azure. El contexto de Azure se autentica con la conexión de servicio de Azure Resource Manager proporcionada.

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.

Entradas

azureConnectionType - Tipo de conexión de Azure
Alias de entrada: ConnectedServiceNameSelector. string. Valores permitidos: ConnectedServiceName (Azure clásico), ConnectedServiceNameARM (Azure Resource Manager). Valor predeterminado: ConnectedServiceNameARM.

azureClassicSubscription - Suscripción clásica de Azure
Alias de entrada: ConnectedServiceName. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceName.

La suscripción de Azure clásica que se va a configurar antes de ejecutar PowerShell.

azureSubscription - Suscripción de Azure
Alias de entrada: ConnectedServiceNameARM. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceNameARM.

La suscripción de Azure Resource Manager que se va a configurar antes de ejecutar PowerShell.

ScriptType - Tipo de script
string. Obligatorio. Valores permitidos: FilePath (Ruta de acceso del archivo de script), InlineScript (Script en línea). Valor predeterminado: FilePath.

Tipo de script: ruta de acceso de archivo o insertada.

ScriptPath - Ruta de acceso del script
string. Opcional. Use cuando ScriptType = FilePath.

Ruta de acceso del script. Debe ser una ruta de acceso completa o una relativa al directorio de trabajo predeterminado.

Inline - Script insertado
string. Opcional. Use cuando ScriptType = InlineScript. Valor predeterminado: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Especifica el script que se va a ejecutar. La longitud máxima de script insertada admitida es de 5000 caracteres. Use un script de un archivo si desea usar un script más largo.

ScriptArguments - Argumentos de script
string.

Parámetros adicionales que se van a pasar a PowerShell. Pueden ser parámetros ordinales o con nombre.

azurePowerShellVersion - versión de Azure PowerShell
Alias de entrada: TargetAzurePs. string. Valores permitidos: LatestVersion (versión instalada más reciente), OtherVersion (Especifique otra versión). Valor predeterminado: OtherVersion.

En el caso de los agentes hospedados, las versiones de Azure PowerShell admitidas son 2.1.0, 3.8.0, 4.2.15.1.1 y 6.7.0. Para elegir la versión más reciente disponible en el agente, seleccione LatestVersion (Versión instalada más reciente).

En el caso de los agentes privados, puede especificar una versión preferida de Azure PowerShell mediante OtherVersion (Especificar otra versión).

preferredAzurePowerShellVersion - Versión de Azure PowerShell preferida
Alias de entrada: CustomTargetAzurePs. string. Necesario cuando TargetAzurePs = OtherVersion.

La versión de Azure PowerShell preferida debe ser una versión semántica adecuada, por ejemplo. 1.2.3.. Regex como 2.\*,2.3.\* no se admite. Actualmente, los agentes hospedados admiten las versiones 2.1.0del módulo de Azure , 3.8.0, 4.2.1y 5.1.1 las versiones 2.1.0del módulo AzureRM , 3.8.0, 4.2.1, , 5.1.16.7.0.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: azureps
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	1.95.0 o superior
Categoría de la tarea:	Implementación

Compartir vía