TFSDeleteProject : suppression de projets d'équipe

  • Article

Vous pouvez supprimer un projet d'équipe de Team Foundation Serverlorsque le projet n'est plus requis à l'aide de TFSDeleteProject. De plus, s'il y a composants non restaurés après une création de projet d'équipe infructueuse, vous pouvez utiliser TFSDeleteProjectpour les supprimer.

Important

TFSDeleteProject détruit définitivement le projet d'équipe qui ne peut alors plus être récupéré. Vous devez sauvegarder toutes les données projet importantes avant d'utiliser TFSDeleteProject.

L'outil en ligne de commande TFSDeleteProject se trouve dans le dossier Lecteur:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE sur les ordinateurs clients qui exécutent Team Explorer. 

Notes

Même si vous vous connectez avec des autorisations d'administration, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges 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 le site Web Microsoft : Contrôle de compte d'utilisateur.

Autorisations requises

Pour utiliser la commande TFSDeleteProject, vous devez être membre du groupe de sécurité Team Foundation Administrators ou Project Administrators. Pour plus d'informations, consultez Autorisations de Team Foundation Server et Groupes, autorisations et rôles par défaut de Team Foundation Server.

TFSDeleteproject [/q] [/force] [/excludewss] /collection:URL TeamProjectName

Paramètres

Option

Description

/q

Facultatif. Utilisez le mode silencieux. Ne demandez pas à l'utilisateur de confirmer.

/force

Facultatif. Spécifie que le processus de suppression doit continuer même si certains composants ne peuvent pas être supprimés.

/excludewss

Facultatif. Spécifie que le site SharePoint associé au projet d'équipe ne doit pas être supprimé. Spécifiez cette option pour conserver le site existant afin que d'autres projets d'équipe puissent continuer à l'utiliser.

/collection:URL

Obligatoire. Spécifie l'URI de la collection du projet d'équipe. Vous devez utiliser le format suivant pour l'URI :http://ServerName:Port/VirtualDirectoryName/CollectionName

Si vous ne spécifiez pas de répertoire virtuel, vous devez utiliser le format suivant pour l'URI :

http://ServerName:Port/CollectionName.

TeamProjectName

Obligatoire. Nom du projet. Si le nom inclut des espaces, mettez-le entre des marques de quotations.

Notes

Lorsque vous créez un projet d'équipe, Team Foundation Server crée des objets de données sur le serveur qui héberge Team Foundation Server et peut créer des objets de données sur le serveur qui héberge produits SharePoint, et le serveur qui héberge SQL Server Reporting Services. Lorsque vous supprimez un projet d'équipe, les rapports sont supprimés automatiquement de SQL Server Reporting Services.

Lorsque vous supprimez un projet d'équipe, vous pouvez choisir de supprimer ou non les objets créés pour prendre en charge le site SharePoint. Toutefois, une erreur peut empêcher Team Foundation Server de créer ou supprimer tous les objets. Pour résoudre ces problèmes, les sections suivantes fournissent des informations générales, des liens vers d'autres ressources et des étapes spécifiques qui vous aident à déterminer la cause du problème, à résoudre le problème et, le cas échéant, à supprimer des objets de données qui restent après l'exécution de TFSDeleteProject.

  • Processus TFSDeleteProject

  • Données qui peuvent ne pas être récupérées

  • Vérifier que les composants de projet d'équipe sont supprimés

  • Suppression des composants restants après la suppression partielle du projet

  • Augmenter le délai d'attente

Processus TFSDeleteProject

Lorsque vous utilisez l'outil de ligne de commande TFSDeleteProject, il supprime en premier les données projet, puis les sites Web de projet.

Phase 1 : TFSDeleteProject supprime les données du projet.

Dans la première phase, TFSDeleteProject exécute automatiquement les étapes suivantes pour supprimer des données de projet d'équipe :

  1. TFSDeleteProject crée un inventaire de tous les composants qui sont des candidats pour la suppression. Cela inclut des composants qui s'intègrent à Gestionnaire de tests, Team Foundation Build et contrôle de version Team Foundation.

  2. TFSDeleteProject supprime le composant qui affiche le nœud de projet dans Team Explorer.

  3. TFSDeleteProject marque les informations de contrôle de version pour la suppression, mais ne supprime pas immédiatement ces informations. Les informations incluent toutes les branches de contrôle de version du projet spécifié, mais aucune autre branche en dehors du projet.

    • Si une branche parente et une branche enfant sont à la fois dans le projet, TFSDeleteProject supprime les deux.

    • Si les branches parent et enfant sont dans des projets différents, TFSDeleteProject signale uniquement la branche spécifiée.

    • Si un autre projet est une branche du projet spécifié, TFSDeleteProject signale uniquement le projet spécifié. Lorsque le projet spécifié est supprimé, le projet de branche devient un orphelin.

  4. TFSDeleteProject supprime immédiatement les données de build, y compris les informations et les données essentielles, les définitions et les agents de build, ainsi que les résultats de tests associés au projet d'équipe. L'outil ne supprime pas d'emplacements de dépôt de la build. Vous n'avez pas besoin de supprimer l'emplacement cible de génération d'un projet d'équipe ancien avant de créer un projet d'équipe qui utilise le même emplacement cible de génération.

    Si le projet spécifié contient une grande quantité de données de génération, la suppression peut ne pas finir dans le délai. Pour contourner ce problème, consultez Augmenter le délai d'attente, puis exécutez encore TFSDeleteProject.

  5. TFSDeleteProject supprime immédiatement les éléments de travail et les champs d'éléments de travail qui appartiennent au projet spécifié, ainsi que toutes les métadonnées non partagées.

    Si le projet spécifié contient une grande quantité de données d'élément de travail, la suppression peut ne pas finir dans le délai. Pour résoudre ce problème, consultez Augmenter le délai d'attente, puis exécutez encore TFSDeleteProject.

Phase 2 : TFSDeleteProject supprime les sites Web du projet.

Dans la deuxième phase, TFSDeleteProject supprime les données suivantes :

Important

L'exécution de ces étapes peut prendre du temps et dégrader ainsi les performances du serveur.

  • TFSDeleteProject Utilise les API Reporting Services pour supprimer des rapports sur le serveur qui héberge Reporting Services.

  • TFSDeleteProject Supprime le site Web du portail du projet sur le serveur qui héberge les produits SharePoint. Cette étape se produit uniquement si le projet possède le site et si la suppression de site n'est pas exclue dans la ligne de commande. (considérez que ces projets de multiple peuvent pointer sur un site unique, mais qu'un seul d'eux peut être le propriétaire où les rapports/les tableaux de bord utilisent ce projet par défaut).

    Notes

    Avant de supprimer un projet d'équipe, vous pouvez vérifier que Reporting Services et les produits SharePoint utilisent les URL de projet appropriées en contrôlant les paramètres du portail. Pour plus d'informations, consultez Ajouter un portail du projet d'équipe.

Si TFSDeleteProject supprime avec succès tous les éléments de données ci-dessus, il retourne le message Done. Pour vérifier ce résultat, consultez Vérifier que les composants du projet d'équipe sont supprimés.

Si un ou plusieurs composants ne sont pas supprimés, vous pouvez réexécuter TFSProjectDelete en utilisant l'option /force pour continuer le processus de suppression même s'il ne peut pas supprimer tous les éléments de données. Avec cette option TFSDeleteProject, ignore un composant qu'il ne peut pas supprimer, retourne un message d'erreur, supprime le composant suivant et laisse les métadonnées de projet d'équipe et paramètres de sécurité intacts.

Données qui peuvent ne pas être récupérées

Les données suivantes peuvent rester dans le déploiement une fois le processus TFSDeleteProject exécuté avec succès :

  • Données de projet d'équipe dans le cube. Les données de projet d'équipe restent dans le cube jusqu'à ce que ce dernier soit régénéré ; le service de contrôleur d'entrepôt supprime alors toutes les données de build historiques qui ont été supprimées des bases de données Team Foundation.

  • Fichiers et dossiers cibles de la génération. Les binaires de génération, les fichiers journaux de génération et les fichiers journaux qui contiennent des résultats des tests sont publiés pendant le processus de génération. Les emplacements de ces fichiers ne sont pas supprimés. Si vous souhaitez supprimer ces fichiers, vous devez les supprimer manuellement.

  • Élément de travail suivant les métadonnées partagées. TFSDeleteProject ne supprime pas les métadonnées de suivi des éléments de travail qui sont partagées par des projets d'équipe.

  • Jeux de réservations de contrôle de version qui contiennent du code partagé. Les jeux de réservations de contrôle de version ne sont pas supprimés si le jeu contient du code de plusieurs projets d'équipe.

Vérifier la suppression de projet

Vous pouvez vérifier la réussite d'une suppression de projet en confirmant que le nœud projet d'équipe ne s'affiche plus dans Team Explorer et que son site Web du portail du projet et ses dossiers de rapports n'existent plus.

Pour vérifier qu'un projet d'équipe a été supprimé avec succès

  1. Ouvrez Team Explorer et vérifiez que le projet n'apparaît pas en tant que nœud du projet.

  2. Ouvrez Internet Explorer et tapez l'URL du site Web du portail du projet. Vérifiez que le site n'existe plus.

  3. Dans Internet Explorer, dans la zone Adresse, tapez l'URL du site Web Reporting Services à l'aide de l'un des formats d'URL suivants :

    • http://ReportingServices/Reports

    • **http://ReportingServices/Reports_**TFSInstance

  4. Dans le Gestionnaire de rapports, cliquez sur Afficher les détails.

  5. Vérifiez que le dossier pour le projet d'équipe supprimé n'apparaît plus. Cliquez sur le dossier racine TfsReports, puis sur le dossier nommé pour la collection de projets d'équipe. Il ne doit plus y avoir un dossier avec le nom du projet supprimé.

  6. Si les rapports ou le site Web est conservé, consultez la procédure suivante.

Suppression des composants restants après la suppression partielle du projet

Si le site Web du portail du projet et le dossier de rapports sont conservés après avoir supprimé un projet d'équipe, supprimez manuellement le site et dossier.

Pour supprimer manuellement des rapports et le site Web du portail d'un projet d'équipe supprimé

  1. Ouvrez une session sur le serveur qui héberge Reporting Services pour le projet d'équipe que vous avez supprimé.

  2. Ouvrez Internet Explorer, et dans la zone Adresse, tapez l'URL du site Web Reporting Services en utilisant un des formats d'URL suivants :

    • https://localhost/Reports

    • **https://localhost/Reports_**TFSInstance

  3. Dans le Gestionnaire de rapports, cliquez sur Afficher les détails.

  4. Cliquez sur le dossier racine TfsReports, puis sur le dossier nommé pour la collection de projets d'équipe.

  5. Activez la case à cocher correspondant au projet d'équipe qui a été supprimé.

  6. Cliquez sur Supprimer.

  7. Cliquez sur OK pour confirmer que vous souhaitez supprimer le dossier rapports pour le projet d'équipe.

  8. Pour supprimer le site Web du portail d'un projet d'équipe supprimé, consultez la page suivante sur le site Web Microsoft : How to: Create, Edit, and Delete Windows SharePoint Services Sites.

Augmenter le délai d'attente

Par défaut, chaque appel de service Web que la commande TFSDeleteProject émet pour supprimer un composant doivent être terminés dans les 10 minutes. S'il y a six appels, le processus pourrait prendre une heure. Si vous souhaitez supprimer un projet d'équipe associé à une grande quantité de données, vous pouvez augmenter ce délai d'attente temporairement.

Notes

Lorsque vous augmentez le délai d'attente, la modification affecte tous les appels de service Web. En général, vous souhaitez garder le délai d'attente à 10 minutes pour empêcher des appels de service Web de dégrader les performances du serveur et provoquer que les utilisateurs ne puissent plus utiliser l'interface utilisateur pour de longues périodes. Par conséquent, après avoir supprimé avec succès le projet, vous devez avancer le délai d'attente de 10 minutes.

Autorisations requises

Pour compléter ces procédures, vous devez être un Administrateur Windows sur le serveur de couche Application.

Important

Toute modification erronée du Registre de l'ordinateur peut provoquer l'instabilité du système. Si vous n'êtes pas familiarisé avec l'utilisation du Registre, évitez d'ajouter ou de supprimer des entrées ou de le modifier de quelque manière que ce soit.

Pour augmenter le délai d'attente pour la commande TFSDeleteProject

  1. Connectez-vous au serveur de couche Application.

  2. Cliquez sur Démarrer, sur Exécuter, tapez regedit, puis cliquez sur OK.

  3. Dans le volet de navigateur, développez HKEY_ LOCAL_MACHINE :

    • Si le serveur exécute un système d'exploitation 32 bits, développez : HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\10.0\TeamFoundation\RequestSettings

    • Si le serveur exécute un système d'exploitation 64 bits, développez : HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\10.0\TeamFoundation\RequestSettings

  4. Si la clé TeamFoundation\RequestSettings n'existe pas, suivez ces étapes pour la créer :

    1. Cliquez avec le bouton droit sur TeamFoundation, pointez sur Nouveau, puis cliquez sur Clé.

    2. Nommez la clé RequestSettings.

    3. Cliquez avec le bouton droit sur RequestSettings, pointez sur Nouveau, puis cliquez sur Valeur DWORD.

    4. Nommez la nouvelle valeur DefaultTimeout.

  5. Cliquez avec le bouton droit sur DefaultTimeout et choisissez Modifier.

  6. Dans Valeur du paramètre, tapez le délai d'attente en millisecondes, puis cliquez Décimal.

    Par exemple, pour augmenter le délai d'attente à 30 minutes, tapez 1800000. Pour avancer le délai d'attente de 10 minutes, tapez 600000.

  7. Cliquez sur OK.

  8. Dans le menu Fichier, cliquez sur Quitter.

Exemple

La commande suivante supprime tous les composants associés au projet d'équipe StoreFront sur le serveur Team Foundation Server AdventureWorks1, dans la collection de projets Collection1 ; ils sont également supprimés de Team Explorer.

TFSDeleteProject /force /collection:http://AdventureWorks1:8080/Collection1 StoreFront

Voir aussi

Tâches

Se connecter aux projets d'équipe et y accéder dans Team Foundation Server

Créer un projet d'équipe

Autres ressources

Gestion des autorisations

Configuration de ressources pour prendre en charge les projets d'équipe

Utilisation des outils en ligne de commande Team Foundation Server