共用方式為

自訂和管理工作項目類型 [witadmin]

  • 發行項

您可以使用下列 witadmin 命令，管理 Team 專案的工作項目類型：

  • destroywitd： 終結工作項目類型，並永久終結該型別的每個工作項目，而不進行修復。

  • exportwitd：將工作項目類型定義匯出至 XML 檔案或 [命令提示字元] 視窗。

  • importwitd：將工作項目類型從 XML 定義檔案匯入到在執行 Team Foundation Server 的伺服器上的 Team 專案。 如果具有相同名稱的工作項目類型已經存在，則新的工作項目類型定義會覆寫既有的定義。 如果工作項目類型尚未存在，則這個命令會建立新的工作項目類型。 若要驗證可定義工作項目類型的 XML，但不是匯入檔案，請使用 /v 選項。

  • listwitd：在 [命令提示字元] 視窗的指定專案顯示工作項目類型的名稱。

  • renamewitd：變更特定專案內工作項目類型的顯示名稱。 執行此命令之後，此型別的工作項目會顯示新名稱。

若要執行 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 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]

參數

參數

描述

/collection:CollectionURL

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

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

http://ServerName:Port/CollectionName

/p:Project

會管理為工作項目類型的 Team 專案。 這個 Team 專案必須在 /collection 參數所指定的專案集合中定義。

/p 參數是必要的，除非您使用 /v 選項執行 importwitd 命令。

/n:TypeName

要終結、匯出、匯入或重新命名的工作項目型別名稱。

/f:FileName

包含要匯出或匯入工作項目類型的 XML 定義檔案其路徑和檔案名稱。 如果您省略這個參數，當您使用 exportwitd 命令時，XML 會在 [命令提示字元] 視窗中出現。

注意事項注意事項
如果您使用的 Windows Vista，則可能沒有特定資料夾的使用權限。如果嘗試將工作項目類型匯出至您沒有權限的位置，登錄模擬技術便會自動重新導向至已匯出的檔案，並將該檔案儲存在虛擬存放區中。若要避免此重新導向，您可以將檔案匯出至您有使用權限的位置。如需登錄模擬的詳細資訊，請參閱 Microsoft 網站：登錄模擬 (英文) 和 Windows Vista 中常見的檔案及登錄模擬問題。

/e:編碼方式

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

/exportgloballists

匯出工作項目類型所參考之全域清單的定義。 全域清單的定義將內嵌至工作項目類型定義 XML。 未指定時，全域清單的定義會被省略。

/v

驗證定義工作項目型別的 XML，但不會匯入 XML 定義檔。

注意事項注意事項
您可以驗證型別定義，而不需指定 Team 專案。對專案範圍群組的參考會被忽略。

/new:NewName

工作項目類型的新名稱。

/noprompt

停用確認提示。

/? 或 help

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

備註

當您使用 destroywitd 命令時，它會終結所有下列物件：

  • 工作項目類型

  • 該型別的所有工作項目

  • 工作項目資料表、長文字資料表和連結資料表中對應的項目

  • 工作項目類型中繼資料快取中的物件

範例

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

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

  • 專案名稱：AdventureWorks

  • 輸入或輸出檔案名稱：myworkitems.xml

  • 工作項目型別名稱：myworkitem

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

Dd312129.collapse_all(zh-tw,VS.110).gif匯出工作項目類型定義

下列命令會將 myworkitem 的定義匯出至 myworkitems.xml 檔案。

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

下列範例會使用 Unicode (UTF-7) 編碼方式，匯出工作項目。

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

Dd312129.collapse_all(zh-tw,VS.110).gif匯出工作項目類型及其參考全域清單的定義

下列範例會匯出工作項目類型及其所參考的全域清單。

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

Dd312129.collapse_all(zh-tw,VS.110).gif列出工作項目類型的定義

下列範例會在 [命令提示字元] 視窗中顯示工作項目類型定義。

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

Dd312129.collapse_all(zh-tw,VS.110).gif匯入工作項目類型定義

下列範例會從 XML 檔案匯入工作項目定義。

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

Dd312129.collapse_all(zh-tw,VS.110).gif驗證工作項目類型的 XML 定義

下列範例會驗證 XML，它會定義工作項目類型，但不會匯入定義。

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

請參閱

工作

建立工作項目類型

概念

自訂專案追蹤資料、表單、工作流程和其他物件

其他資源

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