BatchScript@1 – úloha dávkového skriptu v1

Článek
24. 02. 2025

Pomocí této úlohy můžete spustit Windows .bat nebo .cmd skript. .bat Volitelně může skript nebo .cmd trvale upravovat proměnné prostředí.

Syntax

YAML

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

YAML

# Batch Script v1
# Run a windows cmd or bat 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.

Vstupy

filename - Cestu
string. Povinná hodnota.

Cesta ke skriptu nebo.bat, který .cmd se má spustit. Mělo by se jednat o plně kvalifikovanou cestu nebo cestu relativní k výchozímu pracovnímu adresáři. (Upozorňujeme, že pracovní adresář se může lišit od workingFolderadresáře , který by mohl být zadán pro tuto úlohu.)

arguments - Argumenty
string.

Argumenty předané skriptu .cmd nebo .bat

modifyEnvironment - Upravit prostředí
boolean. Výchozí hodnota: False.

Určuje, jestli změny proměnných prostředí ovlivní následující úlohy.

workingFolder - Pracovní složka
string.

Aktuální pracovní adresář při spuštění skriptu. Výchozí hodnota je složka, ve které je skript umístěný.

failOnStandardError - Selhání při standardní chybě
boolean. Výchozí hodnota: false.

Pokud je to pravda, tato úloha selže, pokud se do datového proudu zapíšou StandardError nějaké chyby.

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tuto úlohu použijte ke spuštění skriptu windows .bat nebo .cmd. Volitelně můžete povolit trvalé úpravy proměnných prostředí.

Poznámka

Tato úloha není kompatibilní s kontejnery Windows. Pokud potřebujete spustit dávkový skript v kontejneru Windows, použijte místo toho úlohu příkazového řádku .

Informace o podpoře více platforem najdete v tématu Skriptování napříč platformami.

Příklady

Vytvořte test.bat v kořenovém adresáři úložiště:

bat

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

Pokud chcete spustit tento skript, přidejte do kanálu následující úlohu.

yml

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

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům , aby mohli spouštět úlohy, které používají tuto úlohu: Cmd
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.83.0 nebo vyšší
Kategorie úloh	Nástroj

Sdílet prostřednictvím