다음을 통해 공유


BatchScript@1 - 일괄처리 스크립트 v1 작업

이 작업을 사용하여 Windows .bat 또는 .cmd 스크립트를 실행합니다. 필요에 따라 .bat or .cmd 스크립트는 환경 변수를 영구적으로 수정할 수 있습니다.

문법

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

입력

filename - 경로
string; 필수 사항입니다.

실행할 or .bat 스크립트의 .cmd 경로입니다. 정규화된 경로이거나 기본 작업 디렉터리에 상대적인 경로여야 합니다. (작업 디렉토리는 이 작업에 대해 지정될 수 있는 와 다를 workingFolder수 있습니다.)


arguments - 인수
string;

or .bat 스크립트에 .cmd 전달된 인수입니다.


modifyEnvironment - 환경 수정
boolean; 기본값은 False입니다.

환경 변수 수정이 후속 작업에 영향을 주는지 여부를 결정합니다.


workingFolder - 작업 폴더
string;

스크립트가 실행될 때의 현재 작업 디렉토리입니다. 기본값은 스크립트가 있는 폴더로 설정됩니다.


표준 오류failOnStandardError - 실패
boolean; 기본값은 false입니다.

이 경우 오류가 StandardError 스트림에 기록되면 이 작업이 실패합니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에도 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성참조하세요.

출력 변수

없음.

비고

이 작업을 사용하여 Windows .bat 또는 .cmd 스크립트를 실행할 수 있습니다. 필요에 따라 환경 변수를 영구적으로 수정할 수 있습니다.

비고

이 작업은 Windows 컨테이너와 호환되지 않습니다. Windows 컨테이너에서 배치 스크립트를 실행해야 하는 경우 대신 명령줄 작업을 사용합니다.

여러 플랫폼 지원에 대한 자세한 내용은 크로스 플랫폼 스크립팅을 참조하세요.

예시

리포지토리의 루트에 test.bat 만듭니다.

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

이 스크립트를 실행하려면 파이프라인에 다음 작업을 추가합니다.

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

요구 사항

요구 사항 설명
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
다음에서 실행 에이전트, DeploymentGroup
요구 자체 호스팅 에이전트에는 이 작업을 사용하는 작업을 실행하기 위해 요구 사항과 일치하는 기능 있어야 합니다. Cmd
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 어느 것이든
settable 변수 어느 것이든
에이전트 버전 1.83.0 이상
작업 범주 유틸리티