Collection (Comando)
Puede usar el comando Collection para adjuntar, desasociar o eliminar una colección de proyectos de equipo de una implementación de Visual Studio Team Foundation Server (TFS).Puede usar también el comando Collection para duplicar la base de datos de una colección existente, cambiar su nombre y adjuntarla a la implementación.Este proceso se conoce a veces como clonar una colección.Sin embargo, no puede usar el comando Collection para crear una colección de proyectos de equipo.Para obtener más información, vea Crear una colección de proyectos de equipo.
Para administrar colecciones interactivamente o para crear una colección, puede usar el nodo Colecciones de proyectos de equipo en la consola de administración para Team Foundation.Para obtener más información, vea Abrir la Consola de administración de Team Foundation y Organizar el servidor con colecciones de proyectos de equipo.
Permisos necesarios
Para usar el comando Collections, debe ser miembro de los grupos siguientes:
el grupo de seguridad Administradores de Team Foundation y el grupo de seguridad Administradores en el servidor o servidores que están ejecutando la consola de administración de Team Foundation
del grupo sysadmin en el servidor o servidores donde se ejecuta la instancia de SQL Server que hospeda las bases de datos de Team Foundation Server.
del grupo Administradores de la granja de servidores para la granja de la que va a eliminar la colección de sitios, si la implementación usa Productos de SharePoint y está usando la opción /delete.
Para obtener más información, vea Permisos de Team Foundation Server.
[!NOTA]
Incluso si inicia una sesión con credenciales administrativas, debe abrir una ventana de símbolo del sistema con privilegios elevados para realizar esta función.
TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName] [/collectionDB:ServerName;DatabaseName] [/clone]
Parámetros
marcador de posición |
Descripción |
|---|---|
CollectionName |
Especifica el nombre de la colección del proyecto de equipo.Si el nombre de la colección contiene espacios, debe incluir el nombre entre comillas (por ejemplo, "Mi Colección"). |
ServerName |
Especifica el nombre del servidor que hospeda la base de datos de configuración de TFS y el nombre de la instancia si desea utilizar una instancia distinta de la predeterminada.Si especifica una instancia, debe usar el siguiente formato: NombreDeServidor\NombreDeInstancia |
DatabaseName |
Especifica el nombre de la base de datos de configuración.De manera predeterminada, el nombre de esta base de datos es TFS_ConfigurationDB. |
Opción |
Descripción |
|---|---|
/attach |
Requerido si no se usa ni /detach ni /delete.Si se especifica esta opción, se debe usar también la opción /collectionDB.Si lo desea, también puede usar /collectionName y /clone con esta opción.Si usa la opción /attach, la base de datos de la colección especificada se agregará a su implementación de TFS. |
/detach |
Requerido si no se usa ni /attach ni /delete.Si se especifica esta opción, se debe usar también la opción /collectionName.Si usa la opción /detach, la base de datos de la colección especificada se detendrá y la colección se desasociará de su implementación de TFS. |
/delete |
Requerido si no se usa ni /detach ni /attach.Si se especifica esta opción, se debe usar también la opción /collectionName.Si usa la opción /delete, la base de datos para la colección especificada se detendrá y la colección se desasociará permanentemente de TFS.No podrá volver a adjuntar la base de datos de colección ni a esta ni a cualquier otra implementación. |
/CollectionName:CollectionName |
Se requiere si se usa /detach o /delete.Si se usa esta opción con /detach o /delete, se especifica la colección que se desasociará o eliminará.Si usa esta opción con /attach, especifica un nuevo nombre para la colección.Si usa esta opción con /attach y /clone, especifica el nombre para la colección duplicada. |
/CollectionDB:ServerName;DatabaseName |
Obligatorio si se utiliza /attach.Esta opción especifica el nombre del servidor que se está ejecutando SQL Server y el nombre de la base de datos de colección hospedada en ese servidor. |
/clone |
Si especifica esta opción, la base de datos de la colección original se adjuntará como un clon en SQL Server y esta base de datos se adjuntará a TFS.Esta opción se usa principalmente como parte de dividir una colección de proyectos de equipo. |
Ejemplo
En el ejemplo siguiente se muestra cómo quitar permanentemente la colección de proyectos de equipo "Proyectos Contoso para becarios de verano" de una implementación de Team Foundation Server.
[!NOTA]
Los ejemplos tienen solo propósitos ilustrativos y son ficticios.No se pretende ni se deduce ninguna asociación real.
TFSConfig Collection /delete /CollectionName:"Contoso Summer Intern Projects"
En el ejemplo siguiente se muestra cómo duplicar la colección de proyectos de equipo "Proyectos Contoso de verano para becarios", asignar el nombre "Proyectos Contoso de invierno para becarios" y adjuntar la colección duplicada a la implementación de Team Foundation Server.
TFSConfig Collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects" /CollectionName:"Contoso Winter Intern Projects" /clone
Vea también
Tareas
Move a Team Project Collection
Split a Team Project Collection
Conceptos
Hacer copias de seguridad y restaurar la implementación