다음을 통해 공유


CopyFiles@1 - 파일 v1 복사 작업

일치 패턴을 사용하여 원본 폴더에서 대상 폴더로 파일을 복사하려면 이 작업을 사용합니다. 일치 패턴은 폴더 경로가 아닌 파일 경로만 일치합니다.

참고

이 작업의 최신 버전은 CopyFiles@2 사용할 수 있습니다.

Syntax

# Copy Files v1
# Copy files from source folder to target folder using minimatch patterns (The minimatch patterns will only match file paths, not folder paths).
- task: CopyFiles@1
  inputs:
    #SourceFolder: # string. Source Folder. 
    Contents: '**' # string. Required. Contents. Default: **.
    TargetFolder: # string. Required. Target Folder. 
  # Advanced
    #CleanTargetFolder: false # boolean. Clean Target Folder. Default: false.
    #OverWrite: false # boolean. Overwrite. Default: false.
    #flattenFolders: false # boolean. Flatten Folders. Default: false.

입력

SourceFolder - 원본 폴더
string.

선택 사항입니다. 복사할 파일이 들어 있는 폴더입니다. 폴더가 비어 있으면 작업은 리포지토리의 루트 폴더에서 지정된 것처럼 $(Build.SourcesDirectory) 파일을 복사합니다.

빌드에서 원본 디렉터리 외부에서 아티팩트가 생성되는 경우 파이프라인에 대해 만든 디렉터리에서 파일을 복사하도록 지정 $(Agent.BuildDirectory) 합니다.


Contents - 내용을
string. 필수 요소. 기본값은 **입니다.

복사본의 일부로 포함할 파일 경로입니다. 이 문자열은 여러 줄의 일치 패턴을 지원합니다.

예를 들면 다음과 같습니다.

  • * 는 지정된 원본 폴더의 모든 파일을 복사합니다.
  • ** 는 지정된 원본 폴더의 모든 파일과 모든 하위 폴더의 모든 파일을 복사합니다.
  • **\bin\** 는 모든 bin 폴더에서 모든 파일을 재귀적으로 복사합니다.

패턴은 폴더 경로가 아닌 파일 경로만 일치하도록 사용됩니다. 대신 와 같은 **\bin\** 패턴을 지정합니다 **\bin.

빌드 에이전트 유형과 일치하는 경로 구분 기호를 사용합니다. 예를 들어 은 / Linux 에이전트에 사용해야 합니다. 아래에는 더 많은 예제가 나와 있습니다.


TargetFolder - 대상 폴더
string. 필수 요소.

복사된 파일을 포함할 대상 폴더 또는 UNC 경로입니다. 변수를 사용할 수 있습니다. 예: $(build.artifactstagingdirectory).


CleanTargetFolder - 대상 폴더 정리
boolean. 기본값은 false입니다.

선택 사항입니다. 복사 프로세스 전에 대상 폴더의 모든 기존 파일을 삭제합니다.


OverWrite - 덮어쓸
boolean. 기본값은 false입니다.

선택 사항입니다. 대상 폴더의 기존 파일을 바꿉니다.


flattenFolders - 폴더 평면화
boolean. 기본값은 false입니다.

선택 사항입니다. 폴더 구조를 평면화하고 모든 파일을 지정된 대상 폴더에 복사합니다.


작업 제어 옵션

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

출력 변수

없음

설명

이 작업의 최신 버전은 CopyFiles@2 사용할 수 있습니다.

일치하는 파일이 없으면 작업은 여전히 성공을 보고합니다. 일치하는 파일이 대상 폴더에 이미 있는 경우 true로 설정되지 않는 한 Overwrite 작업이 실패를 보고합니다.

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
Settable 변수 모두
에이전트 버전 1.91.0 이상
작업 범주 유틸리티

추가 정보