다음을 통해 공유


작업 항목 형식 사용자 지정 및 관리

다음 witadmin 명령을 사용하여 팀 프로젝트의 작업 항목 형식을 관리할 수 있습니다.

  • destroywitd: 작업 항목 형식을 소멸시키고 해당 형식의 모든 작업 항목을 복구하지 않고 영구적으로 소멸시킵니다.

  • exportwitd:  XML 파일 또는 명령 프롬프트 창에 작업 항목 형식의 정의를 내보냅니다.

  • importwitd:  XML 정의 파일의 작업 항목 형식을 Team Foundation Server를 실행하는 서버의 팀 프로젝트로 가져옵니다.이름이 같은 작업 항목 형식이 이미 있는 경우 새 작업 항목 형식이 기존 작업 항목 형식을 덮어씁니다.작업 항목 형식이 아직 없는 경우 이 명령은 새 작업 항목 형식을 만듭니다.작업 항목 형식을 정의하지만 파일을 가져오지 않는 XML의 유효성을 검사하려면 /v 옵션을 사용합니다.

  • listwitd: 명령 프롬프트 창에 지정한 프로젝트에서 작업 항목 형식 이름을 표시합니다.

  • renamewitd: 특정 프로젝트 내의 작업 항목 형식의 표시 이름을 변경합니다.이 명령을 실행한 후 이 형식의 작업 항목이 새 이름을 표시합니다.

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

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

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

작업 항목 형식에 대한 자세한 내용은 프로세스 템플릿에 작업 항목에 대한 형식 정의 추가을 참조하십시오.

[!참고]

Visual Studio의 강력한 도구인 프로세스 편집기를 사용하여 작업 항목 형식을 만들고 수정할 수 있습니다.이 도구는 지원되지 않습니다.자세한 내용은 Microsoft 웹 사이트에서 Team Foundation Server Power Tools 페이지에 나와 있다.

요구 사항

작업 항목 형식이 정의된 팀 프로젝트의 경우 다음 사용 권한이 설정되어 있어야 합니다.

  • 작업 항목 형식을 내보내거나 목록에 추가하려면 프로젝트 관리자 그룹의 멤버이거나 프로젝트 수준 정보 보기 권한을 허용으로 설정해야 한다.

  • 작업 항목 형식을 삭제하거나 가져오거나 이름을 바꾸려면 Team Foundation Administrators 보안 그룹 또는 Project Administrators 보안 그룹의 멤버여야 합니다.

자세한 내용은 Team Foundation Server 권한Team Foundation Server 기본 그룹, 권한 및 역할를 참조하십시오.

[!참고]

관리자 권한으로 로그온한 경우에도 Windows Server 2008을 실행하는 서버에 대해 이 기능을 수행하려면 관리자 명령 프롬프트 창을 열어야 합니다.관리자 권한 명령 프롬프트 창을 열려면 시작을 선택하고 명령 프롬프트에 대한 바로 가기 메뉴를 연 다음 관리자 권한으로 실행을 선택합니다.자세한 내용은 Microsoft 웹 사이트, 사용자 액세스 컨트롤을 참조하십시오.

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

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

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

매개 변수

Parameter

설명

/collection:CollectionURL

팀 프로젝트 컬렉션의 URI를 지정합니다.URI에 대한 형식: http://ServerName:Port/VirtualDirectoryName/CollectionName

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

http://ServerName:Port/CollectionName

/p:프로젝트

작업 항목 형식을 관리할 팀 프로젝트입니다.이 팀 프로젝트는 /collection 매개 변수에 의해 지정된 프로젝트 컬렉션에 정의되어야 합니다.

/v 옵션을 사용하여 importwitd 명령을 실행하지 않는 경우에는 /p 매개 변수가 필요합니다.

/n:TypeName

삭제, 내보내기, 가져오기 또는 이름 바꾸기할 작업 항목 형식 이름입니다.

/f:FileName

내보내거나 가져올 작업 항목 형식이 들어 있는 XML 정의 파일 경로 및 파일 이름입니다.exportwitd 명령을 사용할 때 이 매개 변수를 생략하면 XML이 명령 프롬프트 창에 나타납니다.

참고참고
Windows Vista를 사용 중인 경우 사용자에게 특정 폴더에 대한 사용 권한이 없을 수도 있습니다.작업 항목 형식을 권한이 없는 위치로 내보내려는 경우 레지스트리 가상화 기술을 통해 내보낸 파일이 자동으로 리디렉션되어 가상 저장소에 저장됩니다.이 리디렉션이 발생하지 않도록 하려면 파일을 사용 권한이 설정된 위치로 내보냅니다. 레지스트리 가상화에 대한 자세한 내용은 Microsoft 웹 사이트에서 Registry VirtualizationWindows Vista의 일반 파일 및 레지스트리 가상화 문제를 참조하십시오.

/e:인코딩

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

/exportgloballists

작업 항목 형식이 참조하는 전역 목록 정의를 내보냅니다.전역 목록 정의는 작업 항목 형식 정의의 XML에 포함됩니다.전역 목록 정의는 지정하지 않으면 생략됩니다.

/v

작업 항목 형식을 정의하지만 XML 정의 파일을 가져오지 않을 XML의 유효성을 검사합니다.

참고참고
팀 프로젝트를 지정하지 않고 형식 정의의 유효성을 검사할 수 있습니다.프로젝트 범위 그룹에 대한 참조가 무시됩니다.

/new:NewName

작업 항목 형식의 새 이름입니다.

/noprompt

확인 프롬프트를 비활성화합니다.

/? 또는 help

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

설명

destroywitd 명령을 사용할 때 다음과 같은 모든 개체를 소멸시킵니다.

  • 작업 항목 형식

  • 해당 형식의 모든 작업 항목

  • 작업 항목 테이블, 긴 텍스트 테이블 및 연결 테이블의 해당 항목

  • 작업 항목 형식 메타데이터 캐시의 개체

예제

별도로 지정하지 않으면 각 예제에서는 다음과 같은 값이 적용됩니다.

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

  • 프로젝트 이름: AdventureWorks

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

  • 작업 항목 형식 이름: myworkitem

  • 기본 인코딩: UTF-8

Dd312129.collapse_all(ko-kr,VS.110).gif작업 항목 형식 정의 내보내기

다음 명령은 myworkitem에 대한 정의를 파일 myworkitems.xml로 내보냅니다.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

다음 예제에서는 유니코드(UTF-7) 인코딩을 사용하여 작업 항목 형식을 내보냅니다.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Dd312129.collapse_all(ko-kr,VS.110).gif작업 항목 형식 및 해당 참조된 전역 목록 정의 내보내기

다음 예제에서는 작업 항목 형식과 참조되는 전역 목록을 내보냅니다.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Dd312129.collapse_all(ko-kr,VS.110).gif작업 항목 형식 정의 목록

다음 예제에서는 명령 프롬프트 창에 작업 항목 형식의 정의를 표시합니다.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Dd312129.collapse_all(ko-kr,VS.110).gif작업 항목 형식 정의 가져오기

다음 예제에서는 XML 파일에서 작업 항목 정의를 가져옵니다.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Dd312129.collapse_all(ko-kr,VS.110).gif작업 항목 형식의 XML 정의 유효성 검사

다음 예제에서는 작업 항목 형식을 정의하지만 정의를 않는 XML의 유효성을 검사합니다.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

참고 항목

작업

작업 항목 형식 만들기

개념

프로젝트 추적 데이터, 폼, 워크플로 및 기타 개체 사용자 지정

기타 리소스

witAdmin: 작업 항목 추적을 위한 개체 사용자 지정 및 관리