작업 가져오기

Get 작업은 지정된 옵션을 사용하여 작업 영역에 있는 파일과 폴더의 읽기 전용 복사본을 검색합니다.

매개 변수

Parameter

설명

BuildUri

빌드 URI를 지정합니다.

Workspace

작업 영역 이름을 지정합니다.

Version

versionspec 파일을 지정합니다. 기본적으로 사용된 versionspec은 T 또는 최신 버전입니다. 다른 버전을 가져오도록 TfsBuild.proj 파일의 GetVersion 속성을 설정합니다. 이 동작은 tf.exe get 명령의 /version 옵션에 해당합니다. 자세한 내용은 Get 명령을 참조하십시오.

Filespec

작업 영역에서 항목을 지정합니다. 기본적으로 Team Foundation Build는 WorkspaceName 속성에서 지정한 작업 영역의 모든 항목을 가져옵니다. 특정 Itemspec을 지정하도록 TFSBuild.proj 파일에서 GetFileSpec 속성을 재정의합니다. 이것은 tf.exe get 명령의 Itemspec 매개 변수에 해당합니다.

PopulateOutput

기본적으로 Team Foundation Build는 가져왔거나, 바꿨거나, 삭제한 항목의 목록을 반환하지 않고 Get 작업에서 생성한 경고도 반환하지 않습니다. 이러한 목록을 사용하려면 TFSBuld.proj 파일에서 GetPopulateOutput 속성을 true로 설정합니다. GetPopulateOutput을 true로 설정하면 다음이 반환됩니다.

  • Gets라는 항목 그룹에서 항목 가져오기

  • Replaces라는 항목 그룹에서 항목 바꾸기

  • Deletes라는 항목 그룹에서 항목 삭제

  • GetWarnings라는 항목 그룹에서 경고 표시

Preview

Get 작업을 실제로 수행하지 않은 상태에서 발생하는 작업의 표시 여부를 지정합니다. Get 작업을 미리 보려면 TFSBuild.proj 파일에서 PreviewGet을 true로 설정합니다. 이것은 tf.exe get 명령의 /preview 옵션에 해당합니다.

Recursive

파일을 재귀적으로 검색할지 여부를 지정합니다. Team Foundation Build 프로젝트에서 비재귀적으로 가져오기를 수행하려면 TfsBuild.proj 파일에서 RecursiveGet 속성을 false로 설정합니다. 이것은 tf.exe get 명령의 /recursive 옵션에 해당합니다.

Force

파일을 증분 검색할지 여부를 지정합니다. Team Foundation Build 정의에서 증분 가져오기를 수행하려면 TfsBuild.proj 파일에서 ForceGet 속성을 false로 설정합니다. 이것은 tf.exe get 명령의 /force 옵션에 해당합니다.

Gets

출력 매개 변수. Get 작업에서 검색한 항목의 목록을 지정합니다.

Replaces

출력 매개 변수. Get 작업에서 바꾼 항목의 목록을 지정합니다.

Deletes

출력 매개 변수. Get 작업에서 삭제한 항목의 목록을 지정합니다.

Warnings

출력 매개 변수. Get 작업에서 생성한 경고의 목록을 지정합니다.

설명

Get 작업은 Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll에 정의됩니다. Microsoft.TeamFoundation.Build.targets 파일에는 Team Foundation Build에서 CoreGet 대상의 기본 구현으로 사용하는 Get 작업의 인스턴스가 포함되어 있습니다.

Team Foundation Build 컴퓨터의 <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild 폴더에는 Microsoft.TeamFoundation.Build.targets 파일이 들어 있습니다.

예제

다음 예제에서는 Microsoft.TeamFoundation.Build.targets 파일에 정의되어 있는 Get 작업의 기본 인스턴스를 보여 줍니다.

<Get 
    TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
    BuildUri="$(BuildURI)"
    Workspace="$(WorkspaceName)"
    Version="$(GetVersion)"
    Filespec="$(GetFilespec)"
    PopulateOutput="$(GetPopulateOutput)" 
    Preview="$(PreviewGet)"
    Recursive="$(RecursiveGet)"
    Force="$(ForceGet)">
  <Output TaskParameter="Gets" ItemName="Gets" />
  <Output TaskParameter="Replaces" ItemName="Replaces" />
  <Output TaskParameter="Deletes" ItemName="Deletes" />
  <Output TaskParameter="Warnings" ItemName="GetWarnings" />
</Get>

참고 항목

작업

빌드 번호 사용자 지정

참조

Get 명령

기타 리소스

Team Foundation Build 대상, 작업 및 속성