Partager via


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

Autres ressources

Gestion de la configuration du serveur avec TFSConfig