共用方式為


自訂工作項目類型的分類 [witadmin]

您可以使用下列 witadmin 命令,管理針對 Team 專案所定義的工作項目類型分類。

  • exportcategories:匯出在執行 Team Foundation Server 的伺服器上所定義分類的 XML 定義。

  • importcategories:將工作項目類型 XML 定義檔案匯入到在執行 Team Foundation Server 的伺服器上的 Team 專案。 

    如果具有相同名稱的分類已經存在,這個命令會覆寫現有的定義。 如果工作項目類型尚未存在,則這個命令會建立新的分類。

若要執行 witadmin 命令列工具,請在安裝 Visual Studio 或 Team Explorer 的系統中開啟命令提示字元視窗,並輸入:

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

在 Windows 64 位元版本中,將 %programfiles% 取代為 %programfiles(x86)%。

注意事項注意事項

您可以使用 Visual Studio 的強大工具 [處理序編輯器],建立和修改分類。不支援此強大工具。如需詳細資訊,請參閱 Microsoft 網站的這個網頁:Team Foundation Server Power Tools

需求

對於定義類別的 Team 專案,您必須已設定下列權限:

  • 若要匯出工作項目類型的類別,您必須將 [檢視專案層級資訊] 權限設為 [允許]。

  • 若要匯入工作項目類型的類別,您必須是 [Project Administrators] 安全性群組的成員或擁有 [編輯專案層級資訊] 的權限且已設為 [允許]。

如需詳細資訊,請參閱Team Foundation Server 使用權限Team Foundation Server 預設群組、使用權限和角色

注意事項注意事項

即使您使用系統管理權限登入,還是必須開啟較高權限的命令提示字元視窗,在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟較高權限的 [命令提示字元] 視窗,請選取 [開始],開啟 [命令提示字元] 捷徑功能表,然後選取 [以系統管理員身分執行。]。如需詳細資訊,請參閱 Microsoft 網站:使用者帳戶控制

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

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

參數

參數

描述

/collection:CollectionURL

指定 Team 專案集合的 URI。 URI 的格式如下: http://ServerName:Port/VirtualDirectoryName/CollectionName

如果不使用任何虛擬目錄,則 URI 格式如下:

http: / /ServerName:Port / CollectionName。

/p:Project

匯出類別或匯入類別的 Team 專案名稱。

/f:FileName

包含要匯出或匯入分類的 XML 定義檔案其路徑和檔案名稱。 如果您省略這個參數,當您使用 exportcategories 命令時,該命令會在 [命令提示字元] 視窗中列出分類。

/e:Encoding

.NET Framework 2.0 編碼格式的名稱。 指定的編碼方式將會用來匯出或匯入 XML 資料。 例如 /e:utf-7 會指定 Unicode (UTF-7) 編碼方式。 如果您省略這個參數,witadmin 會嘗試偵測編碼,如果偵測失敗,witadmin 會使用 UTF-8。

/?help

顯示 [命令提示字元] 視窗中命令的說明。

備註

匯入分類檔案會建立分類 (如果它們已經不存在的話)。 如果此分類已經存在,witadmin importcategories 命令將會警告您,將要覆寫目前的清單。 您可以撰寫自己的程式來更新一組現有的類別,或是自行以新的資料更新類別。

重要

您對分類所做的變更可能會影響處理序組態。請參閱 使用處理序組態自訂待處理項目和面板頁面

如需類別 XML 檔案結構的相關資訊,請參閱分類定義結構描述參考

範例

除非另行指定,下列的值會套用在每個範例:

  • Team 專案集合的 URI:http://AdventureWorksServer:8080/tfs/DefaultCollection

  • 專案名稱:AdventureWorks

  • 輸入或輸出檔案名稱:myCategories.xml

  • 預設的編碼方式:UTF-8

Dd273721.collapse_all(zh-tw,VS.110).gif列出工作項目類型分類

下列命令會列出為 AdventureWorks 專案所定義的工作項目類型分類。

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

Dd273721.collapse_all(zh-tw,VS.110).gif匯出工作項目類型分類

下列命令會將為 AdventureWorks 專案定義的工作項目類型分類匯出至 myCategories XML 檔案。

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

Dd273721.collapse_all(zh-tw,VS.110).gif匯入工作項目類型分類

下列範例會將分類從 myCategories XML 檔案匯入 AdventureWorks 專案。

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

請參閱

概念

使用處理序組態自訂待處理項目和面板頁面

其他資源

定義分類以分組工作項目類型

工作項目類型 Categories 項目參考

witAdmin:自訂和管理用於追蹤工作項目的物件