Collection 命令
您可以使用 Collection 命令，在 Visual Studio Team Foundation Server (TFS) 部署上附加、中斷連結或刪除 Team 專案集合。您也可以使用 Collection 命令來複製現有集合的資料庫、將其重新命名，並附加至部署。這項處理有時候會被稱為複製集合。不過，您不能使用 Collection 命令來建立 Team 專案集合。如需詳細資訊，請參閱建立 Team 專案集合。
若要以互動方式管理集合，或是建立集合，您可以使用 Team Foundation 之管理主控台中的 [Team 專案集合] 節點。如需詳細資訊，請參閱 開啟 Team Foundation 管理主控台和 使用 Team 專案集合組織您的伺服器。
必要的使用權限
若要使用 Collections 命令，您必須是下列群組的成員：
正在執行 Team Foundation 之管理主控台的一個或多個伺服器上的 [Team Foundation Administrators] 安全性群組和 [Administrators] 安全性群組
伺服器上的 sysadmin群組，或是正在執行裝載 Team Foundation Server 之資料庫的 SQL Server 的執行個體的多個伺服器
如果您使用 SharePoint 產品部署，而且在使用 /delete選項，就會是從其中刪除網站集合之伺服陣列的 [Farm Administrators] 群組。
如需詳細資訊，請參閱 Team Foundation Server 使用權限。
.gif "注意事項") 注意事項 |
|---|
即使您是使用系統管理認證登入，還是必須開啟更高權限的命令提示字元視窗來執行此功能。 |
TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName] [/collectionDB:ServerName;DatabaseName] [/clone]
參數
預留位置 |
描述 |
|---|---|
CollectionName |
指定 Team 專案集合的名稱。如果集合的名稱包含空格，就必須以引號括住名稱 (例如，"My Collection")。 |
ServerName |
指定裝載 TFS 之組態資料庫的伺服器的名稱，如果您要使用預設執行個體以外的執行個體，也需要指定該執行個體的名稱。如果您指定執行個體，就必須使用下列格式： ServerName\InstanceName |
DatabaseName |
指定組態資料庫的名稱。預設情況下，此資料庫的名稱會是 TFS_ConfigurationDB。 |
選項 |
描述 |
|---|---|
/attach |
如果都不使用 /detach 或 /delete，則為必要項。如果您指定這個選項，也必須使用 /collectionDB 選項。做為選項，您也可以搭配使用 /collectionName 和 /clone 與這個選項。如果您使用 /attach 選項，指定的集合資料庫就會加入至您所部署的 TFS。 |
/detach |
如果都不使用 /attach 或 /delete，則為必要項。如果您指定這個選項，也必須使用 /collectionName 選項。如果您使用 /detach 選項，指定之集合的資料庫將會停止，而且集合將會從您的 TFS 部署中斷連結。 |
/delete |
如果都不使用 /detach 或 /attach，則為必要項。如果您指定這個選項，也必須使用 /collectionName 選項。如果您使用 /delete 選項，指定之集合的資料庫將會停止，而且集合將會從 TFS 永遠中斷連結。您將無法讓集合資料庫重新附加至這個部署或其他任何部署。 |
/CollectionName:CollectionName |
如果有使用 /detach 或 /delete，則會是必要項。如果您搭配 /detach 或 /delete 使用這個選項，它就會指定將要中斷連結或刪除的集合。如果您搭配 /attach 使用這個選項，它就會指定集合的新名稱。如果您同時搭配 /attach 和 /clone 使用這個選項，它就會指定重複之集合的名稱。 |
/CollectionDB:ServerName;DatabaseName |
如果使用 /attach，則為必要項。這個選項會指定執行 SQL Server 之伺服器的名稱，以及在伺服器上裝載之集合資料庫的名稱。 |
/clone |
如果您指定這個選項，就會在 SQL Server 中附加原始集合資料庫做為複製品，而且會將這個資料庫附加至 TFS。這個選項主要用於做為分割 Team 專案集合的部分作業。 |
範例
下列範例示範如何從 Team Foundation Server 的部署，永久移除 "Contoso Summer Intern Projects" Team 專案集合。
| 注意事項 |
|---|
範例僅供解說之用，皆為虛構。沒有影射任何真實存在的人事物，也不應推斷為與其有所關聯。 |
TFSConfig Collection /delete /CollectionName:"Contoso Summer Intern Projects"
下列範例將示範如何複製 "Contoso Summer Interns Projects" Team 專案集合，將其命名為 "Contoso Winter Interns Projects"，並將重複集合附加至 Team Foundation Server 的部署。
TFSConfig Collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects" /CollectionName:"Contoso Winter Intern Projects" /clone
請參閱
工作
Move a Team Project Collection
Split a Team Project Collection