링크 형식 관리[witadmin]
작업 항목 형식과 마찬가지로 사용자 지정 링크 형식을 정의하고 수정할 수 있습니다. 그러나 시스템 정의 링크 형식은 변경할 수 없습니다. 새 링크 형식을 팀 프로젝트 컬렉션에 추가하기 전에 사용 가능한 링크 형식을 검토해야 합니다. 작업 항목을 연결하여 추적 가능성 지원을 참조하세요.
다음 witadmin 명령을 사용하여 팀 프로젝트 컬렉션에 대해 정의된 링크 형식을 관리할 수 있습니다.
deactivatelinktype: 지정된 링크 형식을 비활성화합니다. 사용자가 이 형식의 링크를 더 이상 만들 수 없습니다. 이 형식의 기존 링크는 계속 정상적으로 작동합니다.
deletelinktype: 지정된 링크 형식을 데이터베이스에서 영구적으로 제거합니다. 이 링크 형식으로 정의된 모든 링크도 제거됩니다.
exportlinktype: 링크 형식의 정의를 내보냅니다. 단일 링크 형식 또는 서버에 대해 정의된 모든 링크 형식의 정의를 내보낼 수 있습니다.
importlinktype: XML 파일에서 링크 형식의 정의를 가져옵니다. 참조 이름이 같은 링크 형식이 이미 있으면 해당 링크 형식이 가져온 링크 형식과 일치하도록 업데이트됩니다. 링크 형식이 없으면 새 링크 형식이 만들어집니다.
listlinktypes: 서버의 사용 가능한 링크 형식 집합을 나열합니다.
reactivatelinktype: 지정된 링크 형식을 다시 활성화하고, 선택적으로 새 이름을 할당합니다.
witadmin 명령줄 도구를 실행하려면 Visual Studio 또는 팀 탐색기가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
32비트 버전의 Windows에서는 **%programfiles(x86)%**를 **%programfiles%**로 바꿉니다.
요구 사항
링크 형식이 정의된 팀 프로젝트 컬렉션에 대해 다음 권한 집합이 있어야 합니다.
링크 형식을 나열하거나 내보내려면 컬렉션의 팀 프로젝트에 대한 프로젝트 수준 정보 보기 권한이 허용으로 설정되어 있어야 합니다.
링크 형식을 삭제하거나 가져오거나 다시 활성화하려면 Project Collection Administrators 보안 그룹의 멤버이거나 작업 항목 링크 형식 관리 권한이 허용으로 설정되어 있어야 합니다.
자세한 내용은 Team Foundation Server에 대한 사용 권한 참조을 참조하십시오.
참고
관리 권한으로 로그온한 경우에도 Windows Server 2008을 실행하는 서버에서 이 기능을 수행하려면 관리자 권한 명령 프롬프트 창을 열어야 합니다.관리자 권한 명령 프롬프트 창을 열려면 시작을 선택하고 명령 프롬프트 바로 가기 메뉴를 연 다음 관리자 권한으로 실행을 선택합니다.자세한 내용은 Microsoft 웹 사이트 사용자 액세스 제어를 참조하세요.
witadmin deactivatelinktype /collection:CollectionURL /n:LinkName
witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]
witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding]
witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]
witadmin listlinktypes /collection:CollectionURL
witadmin reactivatelinktype /collection:CollectionURL /n:LinkName
매개 변수
매개 변수 |
설명 |
|---|---|
/collection:CollectionURL |
팀 프로젝트 컬렉션의 URI를 지정합니다. URI의 형식은 다음과 같습니다. http://ServerName:Port/VirtualDirectoryName/CollectionName 예를 들면 다음과 같습니다. http://ServerName:8080/tfs/Collection0 가상 디렉터리를 사용하지 않는 경우 URI 형식은 다음과 같습니다. http://ServerName:Port/CollectionName |
/n:LinkName |
비활성화하거나 삭제할 링크 형식의 이름 또는 참조 이름입니다. |
/f:FileName |
링크 형식의 XML 파일입니다. 가져오기에는 필수 사항이고, 내보내기에는 선택 사항입니다. 이 매개 변수를 생략하면 명령 출력이 디스플레이에 표시됩니다. |
/e:encoding |
.NET Framework 2.0 인코딩 형식의 이름입니다. 지정한 인코딩이 XML 데이터를 가져오거나 내보내는 데 사용됩니다. 예를 들어 /e:utf-7은 유니코드(UTF-7) 인코딩을 지정합니다. 이 매개 변수를 생략하면 witadmin에서 인코딩 검색을 시도하고 검색에 실패하면 witadmin은 UTF-8을 사용합니다. |
/v |
링크 형식 XML을 가져오지 않고 유효성을 검사합니다. |
/noprompt |
확인 프롬프트가 표시되지 않도록 설정합니다. |
/? 또는 help |
명령 프롬프트 창에 명령에 대한 도움말을 표시합니다. |
설명
링크 형식 정의 스키마의 구조는 링크 형식 요소 참조을 참조하세요.
팀 멤버가 만들 수 있는 링크 관계의 형식을 제한하는 방법에 대한 자세한 내용은 링크 컨트롤, 제한 사항 및 필드 참조 및 LinksControlOptions 요소를 참조하세요.
예제
달리 지정하지 않은 경우 각 예제에 다음과 같은 값이 적용됩니다.
팀 프로젝트 컬렉션 URI: http://AdventureWorksServer:8080/tfs/DefaultCollection
서버 이름: AdventureWorksServer
입력 또는 출력 파일 이름: myLinkTypes.xml
링크 형식 이름: mylinktype
기본 인코딩: UTF-8
링크 형식 나열
다음 명령은 Team Foundation AdventureWorksServer에 대해 정의된 사용자 지정 링크 형식을 표시합니다.
witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
링크 형식의 정의 나열
다음 예제에서는 링크 형식의 정의를 명령 프롬프트 창에 표시합니다.
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
링크 형식 비활성화 및 다시 활성화
다음 예제에서는 mylinktype이라는 링크 형식을 비활성화했다가 다시 활성화합니다.
witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
링크 형식의 정의 내보내기
다음 명령은 모든 링크 형식의 정의를 mylinktype.xml 파일로 내보냅니다.
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
링크 형식의 정의 가져오기
다음 예제에서는 XML 파일에 정의된 링크 형식의 정의를 가져옵니다.
witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml