BatchScript@1 — zadanie skryptu usługi Batch w wersji 1
To zadanie służy do uruchamiania systemu Windows .bat lub .cmd skryptu. .bat Opcjonalnie skrypt lub .cmd może trwale modyfikować zmienne środowiskowe.
Składnia
# 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.
# 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.
Dane wejściowe
filename - Ścieżka
string. Wymagane.
Ścieżka skryptu .cmd lub .bat do wykonania. Powinna to być w pełni kwalifikowana ścieżka lub ścieżka względna względem domyślnego katalogu roboczego. (Należy pamiętać, że katalog roboczy może się różnić od workingFolderkatalogu , który można określić dla tego zadania).
arguments - Argumenty
string.
Argumenty przekazane do skryptu .cmd lub .bat .
modifyEnvironment - Modyfikowanie środowiska
boolean. Wartość domyślna: False.
Określa, czy modyfikacje zmiennych środowiskowych będą wpływać na kolejne zadania.
workingFolder - Folder roboczy
string.
Bieżący katalog roboczy po uruchomieniu skryptu. Domyślnie jest to folder, w którym znajduje się skrypt.
failOnStandardError - Błąd standardowy kończy się niepowodzeniem
boolean. Wartość domyślna: false.
Jeśli jest to prawda, to zadanie zakończy się niepowodzeniem, jeśli jakiekolwiek błędy zostaną zapisane w strumieniu StandardError .
Opcje sterowania zadaniami
Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.
Zmienne wyjściowe
Brak.
Uwagi
To zadanie służy do uruchamiania skryptu systemu Windows .bat lub cmd. Opcjonalnie zezwól na trwałe modyfikowanie zmiennych środowiskowych.
Uwaga
To zadanie nie jest zgodne z kontenerami systemu Windows. Jeśli musisz uruchomić skrypt wsadowy w kontenerze systemu Windows, zamiast tego użyj zadania wiersza polecenia .
Aby uzyskać informacje na temat obsługi wielu platform, zobacz obsługa skryptów międzyplatformowych.
Przykłady
Utwórz test.bat w katalogu głównym repozytorium:
@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.
Aby uruchomić ten skrypt, dodaj następujące zadanie do potoku.
- task: BatchScript@1
inputs:
filename: 'test.bat'
Wymagania
| Wymaganie | Opis |
|---|---|
| Typy potoków | YAML, klasyczna kompilacja, wersja klasyczna |
| Działa w | Agent, DeploymentGroup |
| Wymagania | Agenci hostowani samodzielnie muszą mieć funkcje zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: Cmd |
| Możliwości | To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu. |
| Ograniczenia poleceń | Dowolne |
| Zmienne ustawialne | Dowolne |
| Wersja agenta | 1.83.0 lub nowsza |
| Kategoria zadania | Narzędzie |