BatchScript@1 - Attività Script batch v1

2025-07-21

Utilizzare questa attività per eseguire uno script o Windows .bat ..cmd Facoltativamente, lo .bat script or .cmd può modificare in modo permanente le variabili di ambiente.

Sintassi

# 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.

Ingressi dati

filename - percorso
string. Obbligatorio.

Percorso dello .cmd script o .bat da eseguire. Deve trattarsi di un percorso completo o di un percorso relativo alla directory di lavoro predefinita. (Si noti che la directory di lavoro potrebbe differire da workingFolder, che potrebbe essere specificato per questa attività.)

arguments - argomenti
string.

Gli argomenti passati allo .cmd script or .bat .

modifyEnvironment - Modifica ambiente
boolean. Valore predefinito: False

Determina se le modifiche alle variabili di ambiente influiranno sulle attività successive.

workingFolder - cartella di lavoro
string.

La directory di lavoro corrente quando viene eseguito uno script. Per impostazione predefinita, viene utilizzata la cartella in cui si trova lo script.

failOnStandardError - errore standard
boolean. Valore predefinito: false

Se è true, questa attività avrà esito negativo se vengono scritti errori nel flusso StandardError.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di uscita

Nessuno.

Osservazioni:

Utilizzare questa attività per eseguire uno script di .bat o .cmd Windows. Facoltativamente, consentigli di modificare in modo permanente le variabili di ambiente.

Annotazioni

Questa attività non è compatibile con i contenitori di Windows. Se è necessario eseguire uno script batch in un contenitore di Windows, utilizzare invece l'attività della riga di comando .

Per informazioni sul supporto di più piattaforme, vedere Scripting multipiattaforma.

Esempi

Crea test.bat alla radice del repository.

@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.

Per eseguire questo script, aggiungere l'attività seguente alla pipeline.

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

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: Cmd
Funzionalità	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione agente	1.83.0 o versione successiva
Categoria attività	Utilità