I범주 가져오기 및 내보내기

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

중요

온-프레미스 XML 프로세스 모델의 경우 witadmin 을 사용하여 프로젝트의 프로세스를 나열, 가져오기, 내보내기 및 수정할 수 있습니다. 상속된 XML 및 호스트된 XML 프로세스 모델의 경우 witadmin 을 사용하여 프로세스 정보를 나열하고 내보낼 수 있습니다. 프로세스 모델 및 지원되는 항목에 대한 개요는 작업 추적 환경 사용자 지정을 참조하세요.

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

  • exportcategories: 프로젝트에 대해 정의된 범주의 XML 정의를 내보냅니다.
  • importcategories: 작업 항목 형식 XML 정의 파일을 프로젝트로 가져옵니다. 같은 이름을 가진 범주가 이미 있으면 이 명령은 기존 정의를 덮어씁니다. 작업 항목 형식이 아직 없는 경우 이 명령은 새 범주를 만듭니다.

기본 범주 및 해당 범주를 사용하는 방법에 대한 자세한 내용은 범주를 사용하여 작업 항목 유형을 그룹화합니다.

witadmin 명령줄 도구를 실행하는 방법

witadmin 명령줄 도구를 실행하려면 Visual Studio가 설치된 명령 프롬프트 창을 엽니다. witadmin 명령줄 도구는 Visual Studio의 모든 버전과 함께 설치됩니다. 무료 버전의 Visual Studio Community 또는 Visual Studio Team Explorer를 설치하여 이 도구에 액세스할 수 있습니다.

참고

온-프레미스 서버에 연결하는 경우 Azure DevOps Server Visual Studio 또는 팀 탐색기의 동일한 이상 버전을 사용해야 합니다. 예를 들어 TFS 2017 인스턴스에 연결하는 경우 Visual Studio 2017 또는 Team Explorer 2017에서 연결해야 합니다. Team Explorer 2015 버전은 없습니다.

Visual Studio 2019 또는 팀 탐색기 2019 클라이언트:

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

TeamExplorerCommunityEnterpriseProfessional 또는 설치한 버전에 따라 또는 대신에 있습니다.

Visual Studio 2017 또는 Team Explorer 2017 클라이언트:

%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

TeamExplorerCommunityEnterpriseProfessional 또는 설치한 버전에 따라 또는 대신에 있습니다.

32비트 버전의 Windows에서 %programfiles(x86)%를%programfiles%로 바꿉니다. Visual Studio Community(팀 탐색기에 대한 액세스 제공) 또는 Visual Studio Team Explorer 2017을 무료로 설치할 수 있습니다.

witadmin을 사용하면 정의 파일을 가져오고 내보낼 수 있습니다. 사용할 수 있는 다른 도구에는 프로세스 편집기(Visual Studio 버전을 설치해야 합니다)가 포함됩니다. Visual Studio Marketplace에서 프로세스 템플릿 편집기를 설치합니다.

또는 GitHub에서 사용할 수 있는 오픈 소스 클라이언트인 TFS 팀 프로젝트 관리자를 사용할 수 있습니다.

witadmin을 사용하면 정의 파일을 가져오고 내보낼 수 있습니다. 사용할 수 있는 다른 도구에는 프로세스 편집기(Visual Studio 버전을 설치해야 합니다)가 포함됩니다. Visual Studio Marketplace에서 TFS 프로세스 템플릿 편집기를 설치합니다. 이 버전의 프로세스 편집기를 사용하여 이전 스타일의 작업 항목 양식을 수정할 수 있습니다. 새 웹 양식과 연결된 양식을 편집하는 데는 사용할 수 없습니다.

또는 GitHub에서 사용할 수 있는 오픈 소스 클라이언트인 TFS 팀 프로젝트 관리자를 사용할 수 있습니다.

사전 요구 사항

범주가 정의된 프로젝트의 경우 다음 사용 권한을 설정해야 합니다.

  • 작업 항목 유형의 범주를 내보내려면 프로젝트 수준 정보 보기 권한이 허용으로 설정되어 있어야 합니다.
  • 작업 항목 유형의 범주를 가져오려면 프로젝트 관리자 보안 그룹의 구성원이거나 프로젝트 수준 정보 편집 권한이 허용으로 설정되어 있어야 합니다.

자세한 내용은 프로젝트 컬렉션 수준 권한 변경을 참조하세요.

구문

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

매개 변수

매개 변수 설명
/collection:CollectionURL 프로젝트 컬렉션의 URI를 지정합니다. 예를 들면 다음과 같습니다.

온-프레미스 TFS 형식: http://ServerName:Port/VirtualDirectoryName/CollectionName

가상 디렉터리가 사용되지 않는 경우 URI의 형식은 http://ServerName:Port/CollectionName입니다.
/p:Project 범주를 내보낼 프로젝트 또는 범주를 가져올 프로젝트의 이름입니다.
/f:FileName 내보내거나 가져올 범주가 들어 있는 XML 정의 파일의 경로 및 파일 이름입니다. exportcategories 명령을 사용할 때 이 매개 변수를 생략하면 명령 프롬프트 창에 범주가 나열됩니다.
/e:Encoding .NET Framework 2.0 인코딩 형식의 이름입니다. 지정한 인코딩이 XML 데이터를 가져오거나 내보내는 데 사용됩니다. 예를 들어 /e:utf-7 유니코드(UTF-7) 인코딩을 지정합니다. 이 매개 변수를 생략하면 witadmin 이 인코딩을 검색하려고 시도하고 검색에 실패하면 witadmin 은 UTF-8을 사용합니다.
/? 또는 도움말 명령 프롬프트 창에 명령에 대한 도움말을 표시합니다.

설명

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

중요

범주 변경 내용은 프로세스 구성에 영향을 미칠 수 있습니다. ProcessConfiguration XML 요소를 참조하세요.

범주 XML 파일 구조에 대한 자세한 내용은 Categories 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. 기본 설정 텍스트 편집기에서 범주 파일을 열고 해당 요소의 CATEGORY"Hidden Types 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