Collection 命令
使用 Collection 命令可以从 Visual Studio Team Foundation Server (TFS) 部署中附加、分离,或删除团队项目集合。您还可以使用 Collection 命令复制现有集合的数据库、对其进行重命名,以及将其附加到部署。此进程有时被称为克隆集合。但是,不能使用 Collection 命令创建团队项目集合。有关更多信息,请参见创建团队项目集合。
若要以交互方式管理集合或创建集合,您可以使用 Team Foundation 管理控制台中的**“团队项目集合”**节点。有关更多信息,请参见打开 Team Foundation 管理控制台和 使用团队项目集合组织服务器。
必需的权限
若要使用 Collections 命令,您必须是下列组的成员:
正在运行 Team Foundation 管理控制台的服务器上的**“Team Foundation Administrators (Team Foundation 管理员)”安全组和“Administrators”**安全组
正在运行承载 Team Foundation Server 数据库的 SQL Server 实例的服务器上的**“sysadmin”**组
如果您的部署使用 SharePoint 产品 并且您正在使用 /delete 选项,则**“场管理员”**组适用于要从中删除站点集的场。
有关更多信息,请参见Team Foundation Server 权限。
说明 |
---|
即使您是以管理凭据登录,也必须使用提升的命令提示窗口执行此功能。 |
TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName] [/collectionDB:ServerName;DatabaseName] [/clone]
参数
占位符 |
说明 |
---|---|
CollectionName |
指定团队项目集合的名称。如果集合名称包含空格,则必须将名称置于引号中(例如“My Collection”)。 |
ServerName |
指定 TFS 承载配置数据库的服务器的名称以及您要使用的默认实例以外的实例的名称。如果指定一个实例,则您必须使用以下格式: 服务器名称\实例名称 |
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 Foundation Server 部署永久删除“Contoso Summer Intern Projects”团队项目集合。
说明 |
---|
该示例仅适用于阐述并且是虚构。没有实际关联是预期或推断的。 |
TFSConfig Collection /delete /CollectionName:"Contoso Summer Intern Projects"
下面的示例演示如何复制“Contoso Summer Interns Projects”团队项目集合、如何将其命名为“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