自定義和管理工作項類型 [witadmin]

可以使用以下 witadmin 命令管理團隊項目的工作項類型：

• destroywitd：銷燬工作項類型和銷燬永不恢復的該類型的每個工作項。

• exportwitd：將工作項類型的定義導出到 XML 文件或命令提示符窗口。

• importwitd：將工作項類型從 XML 定義文件導入運行 Team Foundation Server 的服務器上的團隊項目。如果具有相同名稱的工作項類型已經存在，則該新工作項類型會覆蓋現有工作項類型。如果工作項類型尚不存在，則此命令將創建一個工作項類型。若要驗證定義工作項類型的 XML，但不導入文件，可以使用 /v 選項。

• listwitd：在命令提示符窗口中顯示指定項目中的工作項類型的名稱。

• renamewitd：更改特定項目中的工作項類型的顯示名稱。運行此命令後，該類型的所有工作項將顯示新名稱。

在運行 團隊資源管理器 的客戶端計算機上，witadmin 命令行實用工具位於驅動器:/Program Files/Microsoft Visual Studio 10.0/Common7/IDE 中。 

有關工作項類型的更多信息，請參見向過程模板添加工作項類型。

必需的權限

對於定義工作項類型處的團隊項目，您必須具有以下權限集：

• 若要導出或列出工作項類型，您必須是“Readers (訪問者)”組的成員，或者將“查看此節點中的工作項”權限設置爲“允許”。

• 若要銷燬、導入或重命名工作項類型，您必須是“Team Foundation Administrators (Team Foundation 管理員)”安全組或“Project Administrators (項目管理員)”安全組的成員。

有關更多信息，請參見 Team Foundation Server 權限 和Team Foundation Server 默認組、權限和角色。

說明

即使您是以管理權限登錄的，也必須使用提升的權限打開命令提示符窗口，才能在運行 Windows Server 2008 的服務器上執行此功能。若要使用提升的權限打開命令提示符窗口，請單擊“開始”，右擊“命令提示符”，然後單擊“以管理員身份運行”。有關更多信息，請參見以下 Microsoft 網站：User Access Control（用戶訪問控制）。

複製

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	指定團隊項目集合的 URI。URI 的格式爲：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果未使用虛擬目錄，則 URI 將爲以下格式： http://ServerName:Port/CollectionName
/p:項目	要爲其管理工作項類型的團隊項目。必須在 /s server 參數指定的項目集合中定義此團隊項目。 除非運行 importwitd 命令和 /v 選項，否則 /p 參數是必需的。
/n:TypeName	要銷燬、導出、導入或重命名的工作項類型的名稱。
/f:FileName	包含要導出或導入的工作項類型的 XML 定義文件的路徑和文件名稱。如果省略此參數，則在使用 exportwitd 命令時，XML 將顯示在命令提示符窗口中。 說明 如果您使用的是 Windows Vista，則可能無權訪問某些文件夾。如果嘗試將工作項類型導出到您沒有權限的位置，註冊表虛擬化技術將自動重定向導出的文件，並將其保存到虛擬存儲區。若要避免此重定向操作，可以將該文件導出到您擁有權限的位置。 有關注冊表虛擬化的更多信息，請參見 Microsoft 網站：Registry Virtualization（註冊表虛擬化）和 Common file and registry virtualization issues in Windows Vista（Windows Vista 中常見的文件和註冊表虛擬化問題）。
/e:編碼	.NET Framework 2.0 編碼格式的名稱。該命令使用指定的編碼導出或導入 XML 數據。例如，/e:utf-7 指定 Unicode (UTF-7) 編碼。如果省略此參數，則 witadmin 將嘗試檢測編碼，並且如果檢測失敗，則 witadmin 將使用 UTF-8。
/exportgloballists	導出工作項類型引用的全局列表的定義。全局列表的定義將嵌入到工作項類型定義 XML。如果未指定，則忽略全局列表的定義。
/v	驗證定義工作項類型的 XML，但不導入 XML 定義文件。 說明 可以驗證類型定義，而不指定團隊項目。忽略對項目範圍組的引用。
/new:NewName	工作項類型的新名稱。
/noprompt	禁用提示進行確認。
/?或help	在“命令提示符”窗口中顯示有關命令的幫助。

備註

---

使用 destroywitd 命令時，它銷燬所有以下對象：

• 工作項類型

• 該類型的所有工作項

• 工作項表、長文本表和鏈接表中的對應項

• 工作項類型元數據緩存中的對象

示例

---

除非另外指定，否則下面的值適用於每個示例：

• 團隊項目集合的 URI：http://AdventureWorksServer:8080/AWTeam/Collection1

• 項目名稱：AdventureWorks

• 輸入或輸出文件的名稱：myworkitems.xml

• 工作項類型名稱：myworkitem

• 默認編碼：UTF-8

導出工作項類型的定義

下面的命令將 myworkitem 的定義導出到文件 myworkitems.xml。

複製

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

下面的示例用 Unicode (UTF-7) 編碼導出工作項。

複製

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

導出工作項類型和其引用的全局列表的定義

下面的示例導出工作項類型和其引用的全局列表。

複製

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

列出工作項類型的定義。

下面的示例在“命令提示符”窗口中顯示工作項類型的定義。

複製

witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /n:myworkitem

導入工作項類型的定義

下面的示例從 XML 文件導入工作項定義。

複製

witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks

驗證工作項類型的 XML 定義

下面的示例驗證定義工作項類型但是不會導入定義的 XML。

複製

witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks /v