Get 명령
파일의 읽기 전용 복사본을 Team Foundation 버전 제어 서버에서 작업 영역으로 가져오고 해당 복사본을 포함하기 위해 디스크에서 폴더를 만듭니다.
필요한 권한
get 명령을 사용하려면 가져온 모든 항목에 대한 읽기 권한이 허용으로 설정되어 있어야 하고 대상 작업 영역을 소유하고 있거나 작업 영역 관리 전역 권한이 있어야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.
tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force]
[/preview] [/recursive] [/remap] [/noprompt] [/login:username,[password]]
매개 변수
인수 |
설명 |
|---|---|
Itemspec |
가져올 파일 또는 폴더입니다. itemspec이 제공되지 않은 경우 Team Foundation Server에서는 현재 작업 영역에 매핑된 모든 항목에 대한 가져오기 작업을 수행합니다. .gif "참고") 참고
Itemspec 인수를 두 개 이상 지정할 수 있습니다.
|
Versionspec |
/version 옵션에 대한 사용자 제공 값입니다. Team Foundation Server에서 버전 사양을 구문 분석하여 범위 내에 있는 항목을 결정하는 방법에 대한 자세한 내용은 명령줄 구문(버전 제어)을 참조하십시오. |
username |
/login 옵션에 값을 제공합니다. 사용자 이름 값을 DOMAIN\UserName 또는 UserName으로 지정할 수 있습니다. |
Option |
설명 |
|---|---|
/version |
선택적 버전 사양입니다. versionspec은 가져올 항목의 버전입니다. 다음을 사용하여 버전을 지정할 수 있습니다.
|
/all |
만료된 파일을 포함하여 모든 파일을 가져옵니다. |
/overwrite |
체크 아웃되지 않은 쓰기 가능한 파일을 덮어씁니다. |
/force |
/all 및 /overwrite를 조합합니다. |
/preview |
Get 작업을 실제로 수행하지 않은 상태에서 발생하는 작업을 표시합니다. |
/recursive |
itemspec과 일치하는 모든 항목을 재귀적으로 가져옵니다. |
/noprompt |
이 작업 중에 표시될 대화 상자를 표시하지 않습니다. |
/remap |
서버의 로컬 매핑을 업데이트하고 다른 분기에서 같은 파일을 이미 다운로드한 경우 파일을 더욱 빠르게 다시 다운로드합니다. 참고
이 옵션은 복잡한 로컬 매핑이 없고 분기 사이를 자주 전환해야 할 때 많이 사용됩니다.
|
/login |
Team Foundation Server에서 사용자를 인증할 사용자 이름과 암호를 지정합니다. |
설명
get 명령은 서버의 항목을 작업 영역으로 가져옵니다. 다른 버전을 제공하지 않으면 최신 서버 버전을 가져옵니다.
팀 개발 환경에서 작업하는 경우 get은 현재 프로젝트의 모든 파일이 팀과 동기화하고 공유 작업의 최신 복사본을 갖고 있는지 확인하기 때문에 가장 자주 사용하는 명령입니다. get 명령은 로컬 디렉터리에서 사용자가 체크 아웃한 파일을 덮어쓰지 않습니다. 공동 작업 환경에서 get 명령을 자주 수행할 수록 팀이 갖고 있는 로컬 파일이 더욱 최신 파일이 됩니다. 그 이유는 get 작업이 팀 동료에 의해 서버에 체크 인된 변경 내용으로 로컬 작업 영역을 채우는 때문입니다. 체크 인 알림(예: 프로젝트 경고에서)이 나타날 때마다 get 작업을 수행하여 작업 영역을 최신 상태로 유지하는 경우 프로젝트의 버전과 프로젝트의 서버 버전 사이의 차이점을 신속하게 해결할 수 있습니다. 보류 중인 변경 내용을 체크 인할 때 서버와 일치시키는 것이 쉽지 않을 수 있는 변경을 방지할 수 있습니다.
get 작업 동안 작업 영역 버전이 요청된 서버 버전과 같은 경우 /all 옵션을 지정하지 않는 한 Team Foundation Server가 디스크에서 파일을 바꾸지 않습니다. /overwrite 옵션을 사용하여 디스크에 여러 파일을 삭제하거나 실수로 덮어쓸 때 때때로 발생하는 관리할 수 없게 된 작업 공간을 일관성 있는 상태로 복원하기 위해 쓸 수 있는 현재 작업 공간 버전을 지정된 서버 버전으로 강제로 덮어쓸 수 있습니다. /force 옵션을 전달하면 Team Foundation Server는 특정 버전을 제공하지 않는 한 작업 공간에서 모든 체크아웃된 항목을 최신 서버 버전으로 덮어씁니다.
get 작업을 수행할 경우 Team Foundation Server는 사용자가 작업 영역을 서버 버전에 마지막으로 동기화한 후에 체크 인된 파일을 서버에서 삭제된 로컬 작업 공간에서 삭제합니다. 서버에서 이름이 바뀌거나 이동된 파일은 서버에서 변경 내용에 맞게 디스크에 재배치됩니다.
실제 가져오기를 수행하는 경우 발생할 상황을 확인하기 위해 로컬 작업 영역에 업데이트를 하지 않고 /preview 옵션을 사용하여 get 명령을 실행할 수 있습니다.
체크 아웃 작업은 체크 아웃되는 파일의 최신 버전 가져오기 작업을 수행하지 않습니다.
작업 영역에서 작업하는 개발자는 다른 개발자가 변경하는 내용으로부터 격리됩니다. 적절하게 가져오기 작업을 수행하면 다른 개발자가 변경한 내용을 적용할 시기를 제어할 수 있습니다. 이상적으로는 일반적으로 한 파일의 변경 내용은 다른 파일의 해당 내용에 종속되어 있기 때문에 한 두 파일이 아닌 버전 제어 파일의 전체 구성을 업데이트할 수 있습니다. 빌드하고 테스트할 수 있는 버전 제어 파일의 일관성 있는 스냅숏이 있는지 확인해야 합니다.
따라서 체크 아웃 작업은 체크 아웃되는 파일의 최신 버전 가져오기 작업을 수행하지 않습니다. 체크 아웃 중인 파일을 하나라도 업데이트하면 스냅숏의 일관성을 위반하게 되며, 버전 제어 파일이 빌드하거나 테스트할 수 없게 구성됩니다. 또는 Team Foundation Server는 사용자가 변경 내용을 체크인하려고 시도할 때 최신 복사본이 없는 경우 충돌 해결 대화 상자가 표시되도록 변경 내용을 체크인 하기 전에 일부 지점에서 최신 버전 가져오기 작업을 수행하도록 합니다.
자동으로 최신 체크 아웃을 가져오도록 Team Foundation Server를 구성할 수도 있습니다. 자세한 내용은 체크 아웃 설정 구성을 참조하십시오.
tf 명령줄 유틸리티를 검색하는 방법에 대한 자세한 내용은 Tf 명령줄 유틸리티 명령을 참조하십시오.
가져오기 프로세스입니다.
작업 영역에서 이미 체크 아웃되었고 서버 버전이 변경된 서버의 항목에 대해 get 명령을 실행하면 작업 영역 및 서버 버전 사이의 파일 충돌을 해결하라는 메시지가 표시됩니다. 자세한 내용은 Resolve 명령을 참조하십시오.
예제
다음 예제에서는 서버에서 314.cs의 최신 버전을 가져옵니다. 314.cs에 대해 보류 중인 변경 내용이 있는 경우 Team Foundation Server는 충돌을 처리하는 방법을 결정하는 데 도움을 주는 확인 프로세스를 시작합니다.
C:\projects>tf get 314.cs
다음 예제에서는 서버에서 1256.cs의 버전 8을 가져옵니다.
참고
1256.cs;8을 사용하는 것은 1256.cs;C8을 사용하는 것과 같습니다. 세미콜론 뒤에 번호만 지정할 경우 기본적으로 변경 집합 버전이 사용됩니다.
C:\>tf get 1256.cs;8
다음 예제에서는 숨김 취소된 모든 항목의 최신 버전을 서버 폴더 및 하위 폴더에서 C:\projects 디렉터리로 가져오고 이러한 버전이 필요한 로컬 폴더를 만듭니다. 폴더 숨김 및 숨김 취소를 수행하는 방법에 대한 자세한 내용은 Workfold 명령을 참조하십시오.
C:\projects>tf get
다음 예제에서는 변경 집합 1999를 사용하여 체크 인된 1256.cs의 버전을 가져오는 다른 방법을 제공합니다.
c:\projects>tf get /version:C1999 1256.cs
- 또는 -
c:\projects>tf get 1256.cs;C1999
다음 예제에서는 변경 집합 271이 만들어질 때 서버에 존재했던 숨김 취소된 모든 항목의 버전을 서버에서 가져옵니다.
c:\projects>tf get /version:C271
다음 예제에서는 “build42"라는 레이블이 지정된 build42를 가져옵니다. 이 예제에서는 보류 중인 변경 내용이 없는 한 작업 영역이 레이블과 일치합니다. 레이블에 없는 파일은 로컬 디스크에서 제거됩니다.
c:\projects>tf get /version:Lbuild42
다음 예제에서는 서버에서 특정 날짜 및 시간의 버전을 가져옵니다.
c:\projects>tf get /version:D2008-01-21T16:00