BatchScript@1 - Batch script v1 taak

2025-06-24

Gebruik deze taak om een Windows- .bat of .cmd scriptscript uit te voeren. Optioneel kan het .bat script of .cmd omgevingsvariabelen permanent wijzigen.

Syntaxis

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

Invoer

filename - pad
string. Verplicht.

Het pad van het .cmd of .bat script om uit te voeren. Dit moet een volledig gekwalificeerd pad zijn of één ten opzichte van de standaardwerkmap. (Houd er rekening mee dat de werkmap kan afwijken van workingFolder, die voor deze taak kan worden opgegeven.)

arguments - argumenten
string.

De argumenten werden doorgegeven aan het .cmd.bat of-script.

modifyEnvironment - Omgeving wijzigen
boolean. Standaardwaarde: False.

Bepaalt of wijzigingen in de omgevingsvariabele van invloed zijn op volgende taken.

workingFolder - werkmap
string.

De huidige werkmap wanneer een script wordt uitgevoerd. Dit wordt standaard ingesteld op de map waarin het script zich bevindt.

failOnStandardError - mislukt bij standaardfout
boolean. Standaardwaarde: false.

Als dit waar is, mislukt deze taak als er fouten naar de StandardError stream worden geschreven.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een Windows-.bat- of .cmd-script uit te voeren. Optioneel kunt u het toestaan om omgevingsvariabelen permanent te wijzigen.

Opmerking

Deze taak is niet compatibel met Windows-containers. Als u een batchscript moet uitvoeren op een Windows-container, gebruikt u in plaats daarvan de opdrachtregeltaak .

Zie platformonafhankelijke scripts voor meer informatie over het ondersteunen van meerdere platforms.

Voorbeelden

Maak test.bat in de hoofddirectory van uw opslagplaats:

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

Als u dit script wilt uitvoeren, voegt u de volgende taak toe aan uw pijplijn.

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

Behoeften

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen taken uit te voeren die gebruikmaken van deze taak: Cmd
Mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welke dan ook
variabelen instellen	Welke dan ook
Agentversie	1.83.0 of hoger
Taakcategorie	Nutsvoorzieningen

Delen via