BatchScript@1 - Úloha Dávkový skript v1

Tato úloha slouží ke spuštění systému Windows .bat nebo .cmd skriptu. Volitelně .bat může skript nebo .cmd trvale upravovat proměnné prostředí.

Syntaxe

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

Vstupy

filename - cesta
string. Povinné.

Cesta ke skriptu nebo.bat, který .cmd se má spustit. Měla by to být plně kvalifikovaná cesta nebo cesta vzhledem k výchozímu pracovnímu adresáři. (Mějte na paměti, že pracovní adresář se může lišit od workingFolderadresáře , který lze zadat pro tento úkol.)

argumentů
string.

Argumenty předané skriptu .cmd nebo .bat .

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

Určuje, zda změny proměnných prostředí ovlivní následné úlohy.

workingFolder - Pracovní složka
string.

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

Selhání failOnStandardError - na standardním chyb
boolean. Výchozí hodnota: false.

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

Možnosti ovládání úloh

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

Výstupní proměnné

Žádné.

Poznámky

Tato úloha slouží ke spuštění skriptu systému Windows .bat nebo .cmd. Volitelně mu můžete povolit trvalou úpravu 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í pro různé platformy.

Příklady

V kořenovém adresáři úložiště vytvořte test.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.

Chcete-li spustit tento skript, přidejte do kanálu následující úlohu.

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

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít schopnosti, které odpovídají následujícím požadavkům ke spouštění úloh, které používají tuto úlohu: Cmd
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	1.83.0 nebo vyšší
Kategorie úkolu	Užitnost