BatchScript@1 — zadanie skryptu wsadowego w wersji 1

Użyj tego zadania, aby uruchomić system Windows .bat lub .cmd skrypt. Opcjonalnie .bat skrypt or .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.

Dane wejściowe

filename - ścieżka
string. To jest wymagane.

Ścieżka skryptu .cmd or .bat do wykonania. Powinna to być w pełni kwalifikowana ścieżka lub ścieżka względna do domyślnego katalogu roboczego. (Należy pamiętać, że katalog roboczy może różnić się od workingFolder, który może być określony dla tego zadania).

arguments - argumenty
string.

Argumenty przekazywane do skryptu .cmd or .bat .

modifyEnvironment - Modyfikowanie środowiska
boolean. Wartość domyślna: False.

Określa, czy modyfikacje zmiennych środowiskowych będą miały wpływ na kolejne zadania.

workingFolder - folder roboczy
string.

Bieżący katalog roboczy, gdy jest uruchamiany skrypt. Domyślnie jest to folder, w którym znajduje się skrypt.

failOnStandardError - niepowodzenie w błędu standardowego
boolean. Wartość domyślna: false.

Jeśli to prawda, to zadanie zakończy się niepowodzeniem, jeśli jakiekolwiek błędy zostaną zapisane w strumieniu StandardError.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

To zadanie służy do uruchamiania skryptu systemu Windows .bat lub skryptu .cmd. Opcjonalnie zezwól mu na trwałe modyfikowanie zmiennych środowiskowych.

Uwaga / Notatka

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 Skrypty międzyplatformowe.

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 na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do 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ń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	1.83.0 lub nowsza
Kategoria zadań	Użyteczność