Collection, commande
Vous pouvez utiliser la commande Collection pour joindre, détacher ou supprimer une collection de projets d'équipe dans un déploiement de Visual Studio Team Foundation Server (TFS).Vous pouvez également utiliser la commande Collection pour dupliquer la base de données d'une collection existante, la renommer et l'attacher au déploiement.Ce processus est parfois désigné sous le nom de « clonage de collection ».Toutefois, vous ne pouvez pas utiliser la commande Collection pour créer une collection de projets d'équipe.Pour plus d'informations, consultez Créer une collection de projets d'équipe.
Pour gérer des collections interactivement ou créer une collection, vous pouvez utiliser le nœud Collections de projets d'équipe dans la console Administration pour Team Foundation.Pour plus d'informations, consultez Ouvrir la console Administration Team Foundation et Organisation de votre serveur avec des collections de projets d'équipe.
Autorisations requises
Pour utiliser la commande Collections, vous devez être membre des groupes suivants :
le groupe de sécurité Team Foundation Administrators et le groupe de sécurité Administrateurs sur le serveur ou les serveurs qui exécutent la console d'administration pour Team Foundation
le groupe sysadmin sur le serveur ou les serveurs qui exécutent l'instance de SQL Server qui héberge les bases de données pour Team Foundation Server
Groupe Administrateurs de batterie pour la batterie de laquelle vous supprimez la collection de sites, si votre déploiement utilise produits SharePoint et que vous utilisez l'option /delete.
Pour plus d'informations, consultez Autorisations de Team Foundation Server.
[!REMARQUE]
Même si vous vous connectez en tant qu'administrateur, vous devez ouvrir une fenêtre d'invite de commandes avec les autorisations élevées pour exécuter cette fonction.
TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName] [/collectionDB:ServerName;DatabaseName] [/clone]
Paramètres
Espace réservé |
Description |
|---|---|
CollectionName |
Spécifie le nom de la collection du projet d'équipe.Si le nom de la collection contient des espaces, vous devez mettre le nom entre guillemets (par exemple, "Ma Collection"). |
ServerName |
Spécifie le nom du serveur qui héberge la base de données de configuration pour TFS et le nom de l'instance si vous souhaitez utiliser une instance autre que l'instance par défaut.Si vous spécifiez une instance, vous devez utiliser le format suivant : NomServeur\NomInstance |
DatabaseName |
Spécifie le nom de la base de données de configuration.Par défaut, le nom de cette base de données est TFS_ConfigurationDB. |
Option |
Description |
|---|---|
/attach |
Obligatoire si ni /detach ni /delete ne sont utilisés.Si vous spécifiez cette option, vous devez également utiliser l'option /collectionDB.En option, vous pouvez également utiliser /collectionName et /clone avec cette option.Si vous utilisez l'option /attach, la base de données de collection spécifiée sera ajoutée à votre déploiement de TFS. |
/detach |
Obligatoire si ni /attach ni /delete ne sont utilisés.Si vous spécifiez cette option, vous devez également utiliser l'option /collectionName.Si vous utilisez l'option /detach, la base de données pour la collection spécifiée sera arrêtée, et la collection sera détachée de votre déploiement de TFS. |
/delete |
Obligatoire si ni /detach ni /attach ne sont utilisés.Si vous spécifiez cette option, vous devez également utiliser l'option /collectionName.Si vous utilisez l'option /delete, la base de données pour la collection spécifiée sera arrêtée, et la collection sera détachée définitivement de TFS.Vous ne serez pas en mesure d'attacher de nouveau la base de données de collection à ce déploiement ou à tout autre. |
/CollectionName:CollectionName |
Obligatoire si /detach ou /delete est utilisé.Si vous utilisez cette option avec /detach ou /delete, elle spécifie la collection qui sera détachée ou supprimée.Si vous utilisez cette option avec /attach, un nouveau nom est spécifié pour la collection.Si vous utilisez cette option avec /attach et /clone, elle spécifie le nom pour la collection dupliquée. |
/CollectionDB:ServerName;DatabaseName |
Requis si /attach est utilisé.Cette option spécifie le nom du serveur qui exécute SQL Server et le nom de la base de données de collection hébergée sur ce serveur. |
/clone |
Si vous spécifiez cette option, la base de données de collection d'origine sera attachée en tant que clone dans SQL Server, et cette base de données sera jointe à TFS.Cette option est utilisée principalement lorsqu'une collection de projets d'équipe est fractionnée. |
Exemple
L'exemple suivant indique comment supprimer définitivement la collection de projets d'équipe « Contoso Summer Intern Projects » d'un déploiement de Team Foundation Server.
[!REMARQUE]
Ces exemples sont fournis à titre d'illustration uniquement et sont fictifs.Aucune véritable association n'est prévue ou déduite.
TFSConfig Collection /delete /CollectionName:"Contoso Summer Intern Projects"
L'exemple suivant illustre comment dupliquer la collection de projets d'équipe « Contoso Summer Intern Projects », la nommer « Contoso Winter Interns Projects » et joindre la collection en double au déploiement de Team Foundation Server.
TFSConfig Collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects" /CollectionName:"Contoso Winter Intern Projects" /clone
Voir aussi
Tâches
Move a Team Project Collection
Split a Team Project Collection
Concepts
Sauvegarde et restauration de votre déploiement