自訂和管理連結類型
您可以使用下列 witadmin 命令，管理針對 Team 專案集合所定義的連結類型。
deactivatelinktype：停用指定的連結類型。 使用者將再也無法建立此類型的連結。 此類型的現有連結仍會繼續正常運作。
deletelinktype：將指定的連結類型永久從資料庫中移除。 以這種連結類型定義的所有連結也會都移除。
exportlinktype：匯出連結類型定義。 您可以匯出為伺服器所定義單一連結型別或所有連結型別的定義。
importlinktype：從 XML 檔案匯入連結類型的定義。 如果具有相同參考名稱的連結類型已經存在，將會更新以符合匯入的連結類型。 如果連結類型尚未存在，將會建立新的連結類型。
listlinktypes：列出伺服器上連線類型的可用集合。
reactivatelinktype：重新啟動指定的連結類型，並選擇性地將新名稱指派給它。
在執行 Team 總管 的用戶端電腦上，witadmin 命令列公用程式位於磁碟機：\Program Files\Microsoft Visual Studio 10.0\Common7\IDE
.gif "注意事項") 注意事項 |
|---|
您可以使用 Visual Studio 的強大工具 [處理序編輯器]，建立和修改連結類型。 不支援此工具。 如需詳細資訊，請參閱下列 Microsoft 網站的網頁：Team Foundation Server Power Tools (2010 年 4 月) (英文)。 |
必要的使用權限
對於定義連結類型的專案集合，您必須已設定下列權限：
若要列出或匯出連結類型，您必須是 [Readers] 群組的成員，或是將 [檢視此節點中的工作項目] 權限設為 [允許]。
若要刪除、匯入或重新啟動連結類型，您必須是 [Team Foundation Administrators] 安全性群組或 [Project 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 |
顯示 [命令提示字元] 視窗中命令的說明。 |
備註
如需連結類型定義結構描述的結構，請參閱使用連結類型。
範例
除非另行指定，下列的值會套用在每個範例：
Team 專案集合的 URI：http://AdventureWorksServer:8080/AWTeam/Collection1
伺服器名稱：AdventureWorksServer
輸入或輸出檔案名稱：myLinkTypes.xml
連結類型名稱：mylinktype
預設的編碼方式：UTF-8
清單連結類型
下列命令會顯示為 Team Foundation AdventureWorksServer 定義的自訂連結類型。
witadmin listlinktypes /collection:http://AdventureWorksServer:8080/AWTeam/Collection1
列出連結類型的定義
下列範例會在 [命令提示字元] 視窗中顯示連結類型定義：
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1
停用然後重新啟動連結類型
下列範例會停用連結類型 mylinktype，然後重新啟動：
witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
匯出連結類型定義
下列命令會將所有連結類型的定義匯出至 mylinktype.xml 檔案：
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml
匯入連結類型定義
下列範例會匯入在 XML 檔案中定義的連結類型定義：
witadmin importlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml