共用方式為

自訂和管理連結類型 [witadmin]

  • 發行項

類似於工作項目類型，您可以定義和修改自訂連結類型。 不過，您無法對系統定義的連結類型進行任何變更。 將新的連結類型加入至 Team 專案集合之前，請先檢閱可供您使用的連結類型。 請參閱 連結工作項目和物件以支援可追蹤性。

您可以使用下列 witadmin 命令，管理針對 Team 專案集合所定義的連結類型。

  • deactivatelinktype：停用指定的連結類型。 使用者將再也無法建立此類型的連結。 這個類型的現有連結會繼續正常運作。

  • deletelinktype：將指定的連結類型永久從資料庫中移除。 以這種連結類型定義的所有連結也會都移除。

  • exportlinktype：匯出連結類型定義。 您可以匯出為伺服器所定義單一連結型別或所有連結型別的定義。

  • importlinktype：從 XML 檔案匯入連結類型的定義。 如果具有相同參考名稱的連結類型已經存在，將會更新為符合匯入的連結類型。 如果連結類型不存在，則會建立新的連結類型。

  • listlinktypes：列出伺服器上可用的連結類型集合。

  • reactivatelinktype：重新啟動指定的連結類型，並選擇性地將新名稱指派給它。

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

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

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

需求

對於定義連結類型的 Team 專案集合，您必須已設定下列權限：

  • 若要列出或匯出連結類型，您必須將 Team 專案集合中的 [檢視專案層級資訊] 使用權限設定為 [允許]。

  • 若要刪除，匯入或回應連結類型，您必須是 [Project Collection Administrators] 安全性群組的成員或有自己的 [管理工作項目連結類型] 其權限已設為 [允許]。

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

注意事項注意事項

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

 
witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

參數

參數

描述

/collection:CollectionURL

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

例如：

http：//ServerName:8080/tfs/Collection0

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

http://ServerName:Port/CollectionName

/n:LinkName

要停用或刪除的連結類型其名稱或參考名稱。

/f:FileName

連結類型的 XML 檔案。 對匯入為必要，對匯出為選擇性。 如果您省略這個參數，命令輸出會出現在顯示器上。

/e:encoding

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

/v

驗證連結型別 XML，而不匯入它。

/noprompt

停用確認提示。

/? 或 help

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

備註

如需連結類型定義結構描述的結構，請參閱連結類型項目參考。

For information about how you can restrict the types of link relationships that team members can make如需如何限制小組成員所能設定之連結關聯性類型的詳細資訊，請參閱連結的工作項目、連結控制項和限制和 LinksControlOptions 項目。

範例

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

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

  • 伺服器名稱：AdventureWorksServer

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

  • 連結類型名稱：mylinktype

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

Dd273716.collapse_all(zh-tw,VS.110).gif清單連結類型

下列命令會顯示為 Team Foundation AdventureWorksServer 定義的自訂連結類型。

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Dd273716.collapse_all(zh-tw,VS.110).gif列出連結類型的定義

下列範例會在 [命令提示字元] 視窗中顯示連結類型定義：

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Dd273716.collapse_all(zh-tw,VS.110).gif停用然後重新啟動連結類型

下列範例會停用連結類型 mylinktype，然後重新啟動：

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

Dd273716.collapse_all(zh-tw,VS.110).gif匯出連結類型定義

下列命令會將所有連結類型的定義匯出至 mylinktype.xml 檔案：

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Dd273716.collapse_all(zh-tw,VS.110).gif匯入連結類型定義

下列範例會匯入在 XML 檔案中定義的連結類型定義：

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

請參閱

概念

連結類型項目參考

連結的工作項目、連結控制項和限制

其他資源

連結工作項目和物件以支援可追蹤性

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