BatchScript@1 - Batch-script v1-taak

Artikel
07/02/2024

Gebruik deze taak om een Windows .bat - of .cmd script uit te voeren. .bat Het script of .cmd kan eventueel omgevingsvariabelen permanent wijzigen.

Syntax

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

Invoerwaarden

filename - Pad
string. Vereist.

Het pad van het .cmd script of .bat dat moet worden uitgevoerd. Dit moet een volledig gekwalificeerd pad zijn of een 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 die worden doorgegeven aan het .cmd script of .bat .

modifyEnvironment - Omgeving wijzigen
boolean. Standaardwaarde: False.

Bepaalt of wijzigingen in omgevingsvariabelen 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 - Fout 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 naast de taakinvoer besturingsopties. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een Windows .bat- of .cmd-script uit te voeren. U kunt eventueel toestaan dat omgevingsvariabelen permanent worden gewijzigd.

Notitie

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 Scripting op meerdere platforms voor informatie over het ondersteunen van meerdere platforms.

Voorbeelden

Maak test.bat in de hoofdmap 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'

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: Cmd
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.83.0 of hoger
Taakcategorie	Hulpprogramma

Delen via