링크 형식 사용자 지정 및 관리
팀 형식과 마찬가지로 사용자 지정 링크 형식을 정의하고 수정할 수 있습니다.그러나 시스템 정의 링크 형식으로 변경할 수 없습니다.팀 프로젝트 컬렉션에 새 링크 형식을 추가하기 전에 사용할 수 있는 링크 형식을 검토합니다.자세한 내용은 작업 항목 및 개체를 연결하여 추적 가능성 지원를 참조하십시오.
다음 witadmin 명령을 사용하여 팀 프로젝트 컬렉션에 대해 정의된 링크 형식을 관리할 수 있습니다.
deactivatelinktype: 지정한 링크 형식을 비활성화합니다.사용자가 더 이상 이 형식의 링크를 만들 수 없습니다.이 형식의 기존 링크는 계속 제대로 작동합니다.
deletelinktype: 지정한 링크 형식을 데이터베이스에서 영구적으로 제거합니다.이 링크 형식으로 정의된 모든 링크가 제거됩니다.
exportlinktype: 링크 형식 정의를 내보냅니다.서버에 대해 정의된 단일 링크 형식 또는 모든 링크 형식 정의를 내보낼 수 있습니다.
importlinktype: XML 파일에서 링크 형식의 정의를 가져옵니다.같은 참조 이름의 링크 형식이 이미 있으면 가져온 링크 형식과 일치하도록 업데이트됩니다.링크 형식이 아직 없는 경우에는 새 링크 형식이 만들어집니다.
listlinktypes: 서버에 사용할 수 있는 링크 형식 집합을 나열합니다.
reactivatelinktype: 지정한 링크 형식을 다시 활성화하고 필요에 따라 새 이름을 할당합니다.
witadmin 명령줄 도구를 실행하려면 Visual Studio 또는 팀 탐색기가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
64비트 버전의 Windows에서는 **%programfiles%**를 **%programfiles(x86)%**로 바꿉니다.
요구 사항
링크 유형이 정의되는 팀 프로젝트 컬렉션에서는 반드시 다음과 같은 권한 집합이 있어야 한다:
필드를 나열하거나 링크 형식을 내보내려면 콜렉션에 있는 팀 프로젝트에 대한 프로젝트 수준 정보 보기 권한을 허용으로 설정해야 합니다.
링크 형식을 삭제하거나, 가져오거나 다시 활성화하려면 Project Collection Administrators 보안 그룹의 멤버이거나, 작업 항목 링크 형식 관리 권한을 허용으로 설정해야 합니다.
자세한 내용은 Team Foundation Server 권한 및 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
매개 변수
Parameter |
설명 |
---|---|
/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 요소를 참조하십시오.
예제
별도로 지정하지 않으면 각 예제에서는 다음과 같은 값이 적용됩니다.
팀 프로젝트 컬렉션 URL: 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