작업 영역 명령(Team Foundation 버전 제어)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
TFVC(Team Foundation 버전 제어) workspace 명령은 작업 영역과 연결된 속성 및 매핑을 생성, 삭제, 보기 또는 수정할 수 있는 방법을 제공합니다.
필수 조건
- 기존 작업 영역을 수정하거나 삭제하려면 소유자이거나 전역 관리인터터 작업 영역 사용 권한이 허용으로 설정되어 있어야 합니다.
- 작업 영역을 만들려면 전역 작업 영역 만들기 권한이 허용으로 설정되어 있어야 합니다.
- 다른 사용자에 대한 작업 영역을 만들려면 관리 작업 영역 등록 권한이 허용으로 설정되어 있어야 합니다.
자세한 내용은 기본 TFVC 권한을 참조 하세요.
구문
tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]
tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]
tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]
매개 변수
다음 섹션에서는 명령의 인수 및 옵션에 대해 workspace 설명합니다.
인수
| Argument | 설명 |
|---|---|
<workspace-name> |
정보를 만들거나 편집하거나 삭제하거나 표시하려는 작업 영역의 이름을 지정합니다. |
<workspace-owner> |
작업 영역의 사용자 이름을 지정합니다. 작업 영역 소유자가 명령을 수행하는 사람이 아닌 경우 이 매개 변수가 필요합니다. |
<computer-name> |
옵션에 값을 /computer 제공합니다. |
<comment> |
옵션에 값을 /comment 제공합니다. |
@<comment-file> |
주석을 읽어야 하는 파일의 경로를 지정합니다. |
<username> |
옵션에 값을 /login 제공합니다. 이 값을 하나 DOMAIN\<username> 또는 <username>으로 지정할 수 있습니다. |
<password> |
옵션에 값을 /login 제공합니다. |
<team-project-collection-url> |
예를 들어 https://myserver:8080/tfs/DefaultCollection만들거나 편집하거나 삭제하거나 정보를 표시하려는 작업 영역이 포함된 프로젝트 컬렉션의 URL입니다. |
<owner-name> |
옵션에 값을 /newowner 제공합니다. |
옵션
| 옵션 | 설명 |
|---|---|
/new |
새 작업 영역을 만듭니다. |
/template |
새 작업 영역을 만들기 위한 템플릿으로 사용할 기존 작업 영역을 지정합니다. 새 작업 영역에서는 기존 작업 영역의 매핑을 사용합니다. |
/delete |
지정된 작업 영역을 삭제합니다. |
/computer |
작업 영역을 만들 컴퓨터의 이름을 지정합니다. 이 옵션은 고급 옵션입니다. |
/comment |
작업 영역을 설명하는 주석을 제공합니다. |
/newname |
기존 작업 영역의 이름을 바꿉니다. |
/noprompt |
대화 상자를 표시하지 않고 지정된 작업 영역 명령을 수행합니다. |
/collection |
프로젝트 컬렉션을 지정합니다. |
/permission |
작업 영역 권한에 대한 옵션을 지정합니다.
Private: 소유자만 작업 영역을 사용하거나, 파일에서 검사, 또는 관리할 수 있습니다.- Public Limited: 모든 유효한 사용자가 작업 영역을 사용할 수 있습니다. 그러나 소유자만 작업 영역에 대한 파일에서 검사 수 있습니다.- Public: 모든 유효한 사용자가 작업 영역을 사용하거나, 파일에서 검사, 또는 관리할 수 있습니다. |
/location |
작업 영역이 만들어지는 위치를 지정합니다.
local: 클라이언트 컴퓨터에서. 이 값은 기본값입니다.- server: Azure DevOps 서버에서 |
/login |
Azure DevOps를 사용하여 사용자를 인증할 사용자 이름 및 암호를 지정합니다. |
/newowner |
작업 영역의 새 소유자에 대한 사용자 이름을 지정합니다. |
설명
작업 영역은 서버에 있는 파일 및 폴더의 로컬 복사본과 로컬로 변경한 내용입니다. 버전 제어 항목을 추가, 편집, 삭제, 이동, 이름 바꾸기 또는 변경하면 변경 내용을 만들고 테스트할 수 있는 작업 영역에서 변경 내용이 격리됩니다. 작업을 팀의 코드베이스에 검사 경우 변경 내용을 서버에 커밋합니다. 작업 영역 외부에 있는 다른 사용자가 사용할 수 있게 됩니다.
명령줄 유틸리티를 사용하는 tf 방법에 대한 자세한 내용은 Team Foundation 버전 제어 명령 사용을 참조 하세요.
작업 영역 만들기
버전 제어 서버에 파일을 추가하거나 서버의 항목을 검사 전에 작업 영역을 만들거나 기존 파일을 현재 디렉터리에 연결해야 합니다. 자세한 내용은 개발 머신에서 Team Foundation 버전 제어 설정을 참조하세요.
현재 디렉터리를 컴퓨터의 기존 작업 영역에 대한 작업 폴더로 만들려면 다음 단계를 수행합니다.
- 기존 작업 영역의 이름은 어디에 있는지
<workspace-name>입력tf workspace <workspace-name>합니다. 작업 영역 편집 대화 상자가 나타납니다. - 새 작업 폴더를 입력하려면 여기를 클릭하십시오.
- 원본 제어 폴더 상자에 현재 디렉터리를 매핑할 서버 경로를 입력합니다.
- 로컬 폴더 상자에 현재 디렉터리를 입력합니다.
- 확인을 선택합니다.
새 작업 영역을 만들 때 옵션의 /new 일부로 템플릿 작업 영역을 지정할 수 있습니다. 템플릿 작업 영역을 지정하면 TFVC는 현재 컴퓨터에 새 작업 영역을 만듭니다. 또한 TFVC는 소유자를 현재 소유자로 설정하고 템플릿 작업 영역에서 새 작업 영역으로 mappings comment다음 작업 영역 속성을 복제본(replica). 이름이 지정되지 않은 경우 시스템은 현재 컴퓨터 이름을 기반으로 하는 이름을 사용합니다. 템플릿을 사용하여 작업 영역을 만들 때 TFVC는 서버에서 매핑되는 파일을 검색하지 않습니다. 명령을 get 사용하여 새 작업 영역을 서버의 최신 버전과 동기화합니다. 자세한 내용은 Get 명령을 참조 하세요.
단일 폴더 매핑
버전 제어 폴더의 직할 자식만 로컬 작업 영역에 매핑하도록 선택할 수 있습니다. 이렇게 하려면 작업 영역 추가 대화 상자$/folder/*의 소스 제어 폴더 상자에 별표(*) wild카드 문자를 추가합니다. 그렇지 않으면 기본적으로 버전 제어 폴더의 모든 자식이 로컬 작업 영역에 재귀적으로 매핑됩니다.
버전 제어 계층 내의 단일 폴더 매핑은 클라이언트 컴퓨터에 다운로드되는 항목 수를 제한하기 때문에 유용합니다. 다운로드한 파일을 제한하는 또 다른 방법은 작업 영역에 필요하지 않은 파일을 은폐하는 것입니다. 자세한 내용은 작업 영역 최적화를 참조하세요. 이 방법은 더 빠른 다운로드 시간을 제공하고 클라이언트 컴퓨터의 디스크 공간을 절약합니다.
작업 영역 삭제
보류 중인 변경 내용이 포함된 작업 영역을 삭제하면 TFVC는 삭제 프로세스의 일부로 보류 중인 변경 내용을 취소합니다. 작업 영역을 삭제해도 해당 작업 영역에 있던 클라이언트 컴퓨터의 파일과 폴더는 삭제되지 않습니다.
참고 항목
수동으로 실행하는 명령에는 사용자 승인을 바이패스하는 옵션이 필요합니다 /noprompt . PowerShell Start() 메서드를 사용하여 명령을 실행하는 경우 주의해야 합니다. PowerShell에서 이 /noprompt 옵션을 자동으로 설정할 수 있습니다.
작업 영역을 삭제할 때 다음을 제공해야 <workspace-owner> 합니다. <workspace-name>
이 workspace 명령을 사용하여 해당 값을 검색할 수 있습니다. 자세한 내용은 작업 영역 명령을 참조하세요.
값을 찾으 <workspace-owner> 려면 다음 명령을 실행합니다.
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
값을 찾으 <workspace-name> 려면 이전 명령의 출력 값을 값으로 <workspace-owner> 사용합니다<OwnerId>. 이 값은 Azure AD(Azure Active Directory) 개체 ID의 형식과 백슬래시 및 사용자 계정 이름을 포함합니다. 전체 값을 사용합니다. 그런 후 다음 명령을 실행합니다.
c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`
작업 영역을 삭제하려면 다음 명령을 실행합니다.
c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`
작업 영역 편집
다음 작업 영역 특성을 변경할 수 있습니다.
- 작업 영역 이름
- Comment(설명)
- 작업 폴더 매핑
작업 영역 사양이 제공되지 않으면 현재 폴더의 작업 영역이 사용됩니다.
예제
다음은 작업 영역 추가 대화 상자를 열고 새 작업 영역을 만드는 예제입니다. 작업 영역 추가 대화 상자를 사용하여 소스 제어 폴더, 소유자, 컴퓨터, 메모 및 로컬 폴더를 편집할 수 있습니다.
c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection
다음 예제에서는 Beta1이라는 새 작업 영역을 만들고 jenh를 작업 영역 소유자로 할당합니다. 새 작업 영역의 소유권을 다른 사용자에게 할당하려면 관리Workspaces 권한이 있어야 합니다. 보안 권한에 대한 자세한 내용은 기본 TFVC 권한을 참조 하세요.
c:\projects>tf workspace /new Beta1;jenh
다음 예제에서는 jenh가 소유한 Beta1 작업 영역을 템플릿으로 사용하여 새 작업 영역을 만듭니다.
c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection
다음 예제에서는 서버에서 Beta1 작업 영역을 제거합니다.
c:\projects>tf workspace /delete Beta1
다음은 현재 작업 영역에 대한 속성을 편집하는 예제입니다.
c:\projects>tf workspace
다음 예제에서는 해당 속성 및 매핑을 볼 수 있도록 jenh가 소유한 Beta1 작업 영역을 엽니다. 관리Workspaces 권한이 있는 경우 작업 영역 속성 및 매핑을 변경할 수 있습니다.
c:\projects> tf workspaces Beta1;jenh