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. 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.
Notes
Même si vous vous connectez en tant qu'administrateur, vous devez ouvrir une fenêtre d'invite de commandes avec des autorisations élevées pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Pour plus d'informations, consultez la page du site Web Microsoft : Contrôle de compte d'utilisateur.
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 Team Foundation Server 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 Team Foundation Server. |
/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 Team Foundation Server. |
/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 Team Foundation Server. 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 sera dupliquée dans SQL Server, et la base de données en double sera jointe à Team Foundation Server. 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.
Notes
Les noms de sociétés, d'organisations, de produits et de domaines, les adresses de messagerie, les logos, et les noms de personnes et de lieux, ou les événements utilisés dans les exemples, sont fictifs. Toute ressemblance avec des noms ou des événements réels est purement fortuite et involontaire.
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
Déplacer une collection de projets d'équipe
Fractionner une collection de projets d'équipe
Concepts
Sauvegarde et restauration de votre déploiement