管理連結類型 [witadmin]
與工作項目類型相似，您也可以定義及修改自訂連結類型。 但您不能變更系統定義的連結類型。 在您將新的連結類型加入 Team 專案集合之前，請先檢閱您可以使用的連結類型。 請參閱 連結工作項目以支援可追蹤性。
您可以使用以下 witadmin 命令，管理針對 Team 專案集合所定義的連結類型：
deactivatelinktype：停用指定的連結類型。 使用者將再也無法建立此類型的連結。 此類型的現有連結仍會繼續正常運作。
deletelinktype：從資料庫中永久移除指定的連結類型。 也會移除以此連結類型定義的所有連結。
exportlinktype：匯出連結類型定義。 您可以匯出針對伺服器所定義的單一連結類型或所有連結類型定義。
importlinktype：從 XML 檔匯入連結類型定義。 若已經有相同參考名稱的連結類型，則會將該連結類型更新為符合匯入的連結類型。 若連結類型不存在，則會建立新的連結類型。
listlinktypes：列出伺服器上連結類型的可用集合。
reactivatelinktype：重新啟用指定的連結類型，並選擇是否為其指派新的名稱。
若要執行 witadmin 命令列工具，請開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗，並輸入：
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
在 Windows 32 位元版本中，將 %programfiles(x86)% 取代為 %%programfiles%。
需求
對於已定義連結類型的 Team 專案集合，您必須設定以下權限：
若要列出或匯出連結類型，您必須將集合中 Team 專案的 [檢視專案層級資訊] 權限設為 [允許]。
若要刪除、匯入或重新啟用連結類型，您必須是 Project Collection Administrators 安全性群組的成員，或將 [管理工作項目連結類型] 權限設定為 [允許]。
如需詳細資訊，請參閱Team Foundation Server 的權限參考。
.gif "注意事項") 注意事項 |
|---|
即使您使用系統管理權限登入，還是必須開啟提升權限的命令提示字元視窗，在執行 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 |
顯示 [命令提示字元] 視窗中命令的說明。 |
備註
如需連結類型定義結構描述的結構，請參閱連結類型項目參考。
若要了解如何限制小組成員可以建立的連結關聯性類型，請參閱連結控制、限制和欄位參考和 LinksControlOptions 項目。
範例
除非另行指定，下列的值會套用在每個範例：
Team 專案集合的 URI：http://AdventureWorksServer:8080/tfs/DefaultCollection
伺服器名稱：AdventureWorksServer
輸入或輸出檔案名稱：myLinkTypes.xml
連結類型名稱：mylinktype
預設編碼：UTF-8
列出連結類型
以下命令會顯示針對 Team Foundation AdventureWorksServer 所定義的自訂連結類型。
witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
列出連結類型定義
下列範例會在命令提示字元視窗中顯示連結類型定義：
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
停用後重新啟用連結類型
以下範例會停用連結類型 mylinktype，然後將其重新啟用：
witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
匯出連結類型定義
以下命令會將所有連結類型定義匯出至檔案 mylinktype.xml：
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
匯入連結類型定義
以下範例會匯入 XML 檔中所定義的連結類型定義：
witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml