BatchScript@1 — zadanie skryptu usługi Batch w wersji 1

Artykuł
04/29/2024

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