AzurePowerShell@1: tarea Azure PowerShell v1

Artículo
07/02/2024

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

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.

Entradas

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

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

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

ConnectedServiceNameARM - Suscripción de Azure
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 del script: ruta de acceso del 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 admitida del script en línea es de 500 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.

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