다음을 통해 공유


I범주 가져오기 및 내보내기[witadmin]

다음 witadmin 명령을 사용하여 팀 프로젝트에 대해 정의된 범주를 가져오고 내보낼 수 있습니다.

  • exportcategories: Team Foundation Server를 실행하는 서버에 정의된 범주의 XML 정의를 내보냅니다.

  • importcategories: Team Foundation Server를 실행하는 서버의 팀 프로젝트로 작업 항목 형식 XML 정의 파일을 가져옵니다.

    같은 이름을 가진 범주가 이미 있으면 이 명령은 기존 정의를 덮어씁니다. 작업 항목 형식이 아직 없는 경우 이 명령은 새 범주를 만듭니다.

기본 범주와 사용 방법에 대한 자세한 내용은 여기를 참조하십시오.

witadmin 명령줄 도구를 실행하려면 Visual Studio 또는 팀 탐색기가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

32비트 버전의 Windows에서는 **%programfiles(x86)%**를 **%programfiles%**로 바꿉니다.

참고

Visual Studio용 강력한 도구인 프로세스 편집기를 사용하여 범주를 만들고 수정할 수 있습니다.이 강력한 도구는 지원되지 않습니다.자세한 내용은 Microsoft 웹 사이트의 Team Foundation Server 파워 도구 페이지를 참조하세요.

요구 사항

범주가 정의되는 팀 프로젝트에 대해 다음과 같은 권한 집합이 있어야 합니다.

  • 작업 항목 형식의 범주를 내보내려면 프로젝트 수준 정보 보기 권한이 허용으로 설정되어 있어야 합니다.

  • 작업 항목 형식의 범주를 가져오려면 Project Administrators 보안 그룹의 멤버이거나 프로젝트 수준 정보 편집 권한이 허용으로 설정되어 있어야 합니다.

witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding] 

witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding] 

매개 변수

매개 변수

설명

/collection:CollectionURL

팀 프로젝트 컬렉션의 URI를 지정합니다. URI의 형식은 다음과 같습니다. http://ServerName:Port/VirtualDirectoryName/CollectionName

가상 디렉터리를 사용하지 않는 경우 URI 형식은 다음과 같습니다.

http://ServerName:Port/CollectionName 형식의 URI를 지정해야 합니다.

/p:Project

범주를 내보내거나 가져오는 팀 프로젝트의 이름입니다.

/f:FileName

내보내거나 가져올 범주가 들어 있는 XML 정의 파일의 경로 및 파일 이름입니다. exportcategories 명령을 사용할 때 이 매개 변수를 생략하면 이 명령은 명령 프롬프트 창에 범주를 나열합니다.

/e:Encoding

.NET Framework 2.0 인코딩 형식의 이름입니다. 지정한 인코딩이 XML 데이터를 가져오거나 내보내는 데 사용됩니다. 예를 들어 /e:utf-7은 유니코드(UTF-7) 인코딩을 지정합니다. 이 매개 변수를 생략하면 witadmin에서 인코딩 검색을 시도하고 검색에 실패하면 witadmin은 UTF-8을 사용합니다.

/? 또는 help

명령 프롬프트 창에 명령에 대한 도움말을 표시합니다.

설명

범주가 아직 없는 경우 범주 파일을 가져오면 범주가 만들어집니다. 범주가 이미 있는 경우에는 witadmin importcategories 명령에서 현재 목록을 덮어쓰게 된다는 경고 메시지를 표시합니다. 기존 범주 집합을 업데이트하는 고유 프로그램을 작성하거나 직접 새로운 데이터로 범주를 업데이트할 수 있습니다.

중요

범주 변경 내용은 프로세스 구성에 영향을 미칠 수 있습니다.팀 프로젝트의 Agile 계획 도구 구성 및 사용자 지정을 참조하세요.

범주 XML 파일 구조에 대한 자세한 내용은 범주 XML 요소 참조을 참조하십시오.

예제

달리 지정하지 않은 경우 각 예제에 다음과 같은 값이 적용됩니다.

  • 팀 프로젝트 컬렉션 URI: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • 프로젝트 이름: AdventureWorks

  • 입력 또는 출력 파일 이름: myCategories.xml

  • 기본 인코딩: UTF-8

범주 나열

다음 명령은 AdventureWorks 프로젝트에 대해 정의된 작업 항목 형식 범주를 나열합니다.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks 

숨겨진 형식 범주에 범주 추가

숨겨진 형식 범주에 범주를 추가하여 사용자가 해당 범주의 작업 항목 형식을 만들 수 있도록 하는 지원을 제거합니다.

  1. 팀 프로젝트에 대한 범주 정의 파일을 내보냅니다.

    witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml 
    
  2. 원하는 텍스트 편집기에서 범주 파일을 열고 "Hidden Types Category"의 CATEGORY 요소를 찾습니다.

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
       <DEFAULTWORKITEMTYPE name="Code Review Request" />
       <WORKITEMTYPE name="Code Review Response" />
       <WORKITEMTYPE name="Feedback Request" />
       <WORKITEMTYPE name="Feedback Response" />
       <WORKITEMTYPE name="Shared Steps" />
    </CATEGORY>
    
  3. 추가하려는 작업 항목 형식의 이름을 지정하는 WORKITEMTYPE 요소를 추가합니다.

    예를 들어 다음 구문은 사용자 지정 작업 항목 형식 "통합 빌드"를 숨겨진 형식 범주에 추가합니다.

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
       <DEFAULTWORKITEMTYPE name="Code Review Request" />
       <WORKITEMTYPE name="Code Review Response" />
       <WORKITEMTYPE name="Feedback Request" />
       <WORKITEMTYPE name="Feedback Response" />
       <WORKITEMTYPE name="Shared Steps" />
       <WORKITEMTYPE name="Integration Build" />
    </CATEGORY>
    
  4. 범주 정의 파일을 팀 프로젝트로 가져옵니다.

    witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml 
    

참고 항목

개념

팀 프로젝트의 Agile 계획 도구 구성 및 사용자 지정

기타 리소스

범주를 사용하여 작업 항목 형식 그룹화