BatchScript@1 - Tarea de script por lotes v1

Utilice esta tarea para ejecutar un script o .cmd una ventana de .bat Windows. Opcionalmente, el script or .cmd puede modificar permanentemente las .bat variables de entorno.

Sintaxis

# Batch script v1
# Run a Windows command or batch script and optionally allow it to change the environment.
- task: BatchScript@1
  inputs:
    filename: # string. Required. Path. 
    #arguments: # string. Arguments. 
    #modifyEnvironment: False # boolean. Modify Environment. Default: False.
  # Advanced
    #workingFolder: # string. Working folder. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

Entradas

filename - ruta de acceso
string. Obligatorio.

La ruta de acceso del .cmd script or .bat que se va a ejecutar. Debe ser una ruta de acceso completa o una relativa al directorio de trabajo predeterminado. (Tenga en cuenta que el directorio de trabajo podría diferir de workingFolder, que podría especificarse para esta tarea).

argumentos de arguments -
string.

Los argumentos pasados al .cmd script or .bat .

modifyEnvironment - Modificar entorno
boolean. Valor predeterminado: False.

Determina si las modificaciones de las variables de entorno afectarán a las tareas posteriores.

de carpeta de trabajo de workingFolder -
string.

El directorio de trabajo actual cuando se ejecuta un script. El valor predeterminado es la carpeta en la que se encuentra el script.

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

Si esto es true, esta tarea producirá un error si se escriben errores en la secuencia de StandardError.

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, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea para ejecutar un script de Windows .bat o .cmd. Opcionalmente, permitirle modificar permanentemente las variables de entorno.

Nota:

Esta tarea no es compatible con contenedores de Windows. Si necesita ejecutar un script por lotes en un contenedor de Windows, use la tarea de línea de comandos en su lugar.

Para obtener información sobre la compatibilidad con varias plataformas, consulte Scripting multiplataforma.

Ejemplos

Cree test.bat en la raíz de su repositorio:

@echo off
echo Hello World from %AGENT_NAME%.
echo My ID is %AGENT_ID%.
echo AGENT_WORKFOLDER contents:
@dir %AGENT_WORKFOLDER%
echo AGENT_BUILDDIRECTORY contents:
@dir %AGENT_BUILDDIRECTORY%
echo BUILD_SOURCESDIRECTORY contents:
@dir %BUILD_SOURCESDIRECTORY%
echo Over and out.

Para ejecutar este script, agregue la siguiente tarea a la canalización.

- task: BatchScript@1
  inputs:
    filename: 'test.bat'

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: Cmd
Capacidades	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	1.83.0 o superior
Categoría de tarea	Utilidad