다음을 통해 공유


BatchScript@1 - Batch 스크립트 v1 작업

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

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.

입력

filename - 경로
string. 필수 요소.

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


arguments - 인수
string.

또는 .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'

요구 사항

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