AzurePowerShell@3: tarea de Azure PowerShell v3

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.

Esta versión de la tarea está en desuso; use AzurePowerShell@5.

Sintaxis

# Azure PowerShell v3
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@3
  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'. 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.
  # 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
    #validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.

Entradas

azureConnectionType - de 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 - de suscripción clásica de Azure
Alias de entrada: ConnectedServiceName. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName.

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

azureSubscription - de suscripción de Azure
Alias de entrada: ConnectedServiceNameARM. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceNameARM.

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

tipo de script de ScriptType -
string. 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 de 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.

de script insertado de
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 5000 caracteres. Use un script de un archivo si desea usar un script más largo.

argumentos de script de ScriptArguments -
string. Opcional. Use cuando ScriptType = FilePath.

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

errorActionPreference - errorActionPreference
string. Valores permitidos: stop, continue, silentlyContinue. Valor predeterminado: stop.

Selecciona el valor de la variable ErrorActionPreference para ejecutar el script.

FailOnStandardError - error en la de error estándar
boolean. Valor predeterminado: false.

Cuando esto es true, se producirá un error en esta tarea si se escriben errores en la canalización de errores o si se escribe algún dato en el flujo de error estándar.

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 admitidas de Azure PowerShell se 2.1.0, 3.8.0, 4.2.1, 5.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 (Especifique otra versión).

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

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

validateScriptSignature - validar la firma de script
boolean. Opcional. Use cuando ScriptType = FilePath. Valor predeterminado: false.

Si esto es true, la tarea comprobará primero para asegurarse de que el script especificado está firmado y válido antes de ejecutarlo.

Opciones de control de tareas

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

Variables de salida

Ninguno.

Observaciones

Se ha agregado compatibilidad con Error en error estándar y ErrorActionPreference.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Los agentes autohospedados deben tener funcionalidades que coincidan con los siguientes exigen ejecutar trabajos que usen esta tarea: azureps
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	2.0.0 o superior
Categoría de tarea	Desplegar