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. 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 en un servidor que ejecute Windows Server 2008. Para abrir una ventana de símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, vea esta página del sitio web de Microsoft: User Account Control.
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 Team Foundation Server 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 colección especificada se agregará a su implementación de Team Foundation Server. |
/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 Team Foundation Server. |
/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 Team Foundation Server. 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 colección se duplicará en SQL Server y la base de datos duplicada se adjuntará a Team Foundation Server. 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
Las compañías, organizaciones, productos, nombres de dominio, direcciones de correo electrónico, logotipos, personas, lugares y eventos que se describen aquí son ficticios. No se pretende ni se debe deducir asociación alguna con compañías, organizaciones, productos, nombres de dominio, direcciones de correo electrónico, logotipos, personas, lugares o eventos reales.
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
Mover una colección de proyectos de equipo
Dividir una colección de proyectos de equipo
Conceptos
Hacer copias de seguridad y restaurar la implementación