TFSDeleteProject: Löschen von Teamprojekten

  • Artikel

Sie können ein Teamprojekt aus Team Foundation Server entfernen, wenn das Projekt nicht mehr erforderlich ist, indem Sie TFSDeleteProject verwenden. Außerdem, wenn es Komponenten gibt, die nach einer fehlgeschlagenen Teamprojekterstellung ungelöscht bleiben, können Sie sie mithilfe von TFSDeleteProject entfernen.

Wichtig

TFSDeleteProject zerstört das Teamprojekt permanent, wonach es nicht wiederhergestellt werden kann. Sichern Sie alle wichtigen Projektdaten, bevor Sie TFSDeleteProject verwenden.

Das TFSDeleteProject-Befehlszeilentool befindet sich im Verzeichnis <Laufwerk:\Programme\Microsoft Visual Studio 10.0\Common7\IDE auf dem Team Explorer-Clientcomputer. 

Tipp

Sie müssen auch dann ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, wenn Sie sich mit Administratorrechten anmelden, um diese Funktion auf einem Server nutzen zu können, auf dem Windows Server 2008 ausgeführt wird. Klicken Sie zum Öffnen eines Eingabeaufforderungsfensters mit erhöhten Rechten auf Start, klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen. Weitere Informationen finden Sie auf der folgenden Microsoft-Website: Benutzerzugriffssteuerung.

Erforderliche Berechtigungen

Zum Verwenden des TFSDeleteProject-Befehls müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder Projektadministratoren sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen und Team Foundation Server: Standardgruppen, Berechtigungen und Rollen.

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

Parameter

Option

Beschreibungen

/q

Optional. Verwendung des unbeaufsichtigten Modus. Der Benutzer wird nicht zur Bestätigung aufgefordert.

/force

Optional. Gibt an, dass der Löschprozess fortfahren soll, auch wenn einige Komponenten nicht gelöscht werden können.

/excludewss

Optional. Gibt an, dass die SharePoint-Website, die dem Teamprojekt zugeordnet wird, nicht gelöscht werden soll. Geben Sie diese Option an, um die vorhandene Website beizubehalten, damit andere Teamprojekte sie weiterhin verwenden können.

/collection:URL

Erforderlich. Gibt den URI der Teamprojektsammlung an. Folgendes Format muss für den URI verwendet werden: http://ServerName:Port/VirtuellerVerzeichnisname/Auflistungsname

Wenn Sie kein virtuelles Verzeichnis angeben, müssen Sie das folgende Format für den URI verwenden:

http://Servername:Port/Auflistungsname.

TeamProjectName

Erforderlich. Der Name des Projekts. Wenn der Name Leerzeichen enthält, schließen Sie sie in Anführungszeichen ein.

Hinweise

Wenn Sie ein Teamprojekt erstellen, erstellt Team Foundation Server Datenobjekte auf dem Server, der Team Foundation Server hostet, und erstellt ggf. Datenobjekte auf dem Server, der SharePoint-Produkte hostet, und auf dem Server, der SQL Server Reporting Services hostet. Wenn Sie ein Teamprojekt entfernen, werden die Berichte automatisch aus SQL Server Reporting Services entfernt.

Wenn Sie ein Teamprojekt entfernen, können Sie auswählen, ob Sie die Objekte entfernen möchten, die erstellt wurden, um die SharePoint-Website zu unterstützen. Ein Fehler kann jedoch Team Foundation Server hindern, alle Objekte zu erstellen oder zu löschen. Um diese Probleme zu beheben, enthalten die folgenden Abschnitte Hintergrundinformationen, Links zu anderen Ressourcen und bestimmte Schritte, die Ihnen die Bestimmung der Ursache des Problems, das Beheben des Problems, und wenn nötig das Löschen von Datenobjekten ermöglichen, die nach dem Ausführen von TFSDeleteProject übrig bleiben.

  • TFSDeleteProject-Prozess

  • Daten, die ungelöscht bleiben dürfen

  • Überprüfen, ob die Teamprojektkomponenten gelöscht wurden

  • Entfernen von verbleibenden Komponenten nach unvollständigem Löschen des Projekts

  • Timeout-Zeitraum vergrößern

TFSDeleteProject-Prozess

Wenn Sie das TFSDeleteProject-Befehlszeilentool verwenden, werden zuerst Projektdaten und anschließend Projektwebsites gelöscht.

Phase 1: TFSDeleteProject löscht Projektdaten

In der ersten Phase führt TFSDeleteProject die folgenden Schritte automatisch aus, um Teamprojektdaten zu entfernen:

  1. TFSDeleteProject erstellt ein Inventar aller Komponenten, die für das Löschen in Frage kommen. Dies schließt Komponenten ein, die mit Test Manager, Team Foundation Build und Team Foundation-Versionskontrolle interagieren.

  2. TFSDeleteProject löscht die Komponente, die den Projektknoten in Team Explorer anzeigt.

  3. TFSDeleteProject kennzeichnet die Versionskontrolleninformationen zum Löschen, aber löscht nicht sofort diese Informationen. Die Informationen enthalten alle Versionskontrollenverzweigungen im angegebenen Projekt, aber keine anderen Verzweigungen außerhalb des Projekts.

    • Wenn eine übergeordnete Verzweigung und eine untergeordnete Verzweigung im Projekt sind, kennzeichnet TFSDeleteProject beide zum Löschen.

    • Wenn übergeordnete und untergeordnete Verzweigungen in unterschiedlichen Projekten sind, kennzeichnet TFSDeleteProject nur die angegebene Verzweigung.

    • Wenn ein anderes Projekt eine Verzweigung aus dem angegebenen Projekt ist, kennzeichnet TFSDeleteProject nur das angegebene Projekt. Wenn das angegebene Projekt gelöscht wird, wird das Verzweigungsprojekt ein Waise.

  4. TFSDeleteProject löscht sofort Builddaten, einschließlich Informations- und Kerndaten, Builddefinitionen, Build-Agents und Testergebnissen, die dem Teamprojekt zugeordnet sind. Das Tool löscht keine Buildablagespeicherorte. Sie müssen nicht den Buildablagespeicherort eines alten Teamprojekts löschen, bevor Sie ein Teamprojekt erstellen, für das der gleiche Buildablagespeicherort verwendet wird.

    Wenn das angegebene Projekt eine große Menge an Builddaten enthält, könnte das Löschen nicht innerhalb des Timeouts beendet werden. Informationen zur Umgehung des Problems finden Sie unter Timeout-Zeitraum vergrößern. Führen Sie anschließend erneut TFSDeleteProject aus.

  5. TFSDeleteProject löscht sofort Arbeitsaufgaben und Arbeitsaufgabenfelder, die zum angegebenen Projekt gehören, und alle nicht freigegebenen Metadaten.

    Wenn das angegebene Projekt eine große Menge an Arbeitsaufgabendaten enthält, könnte das Löschen nicht innerhalb des Timeouts beendet werden. Informationen zur Lösung des Problems finden Sie unter Timeout-Zeitraum vergrößern. Führen Sie anschließend erneut TFSDeleteProject aus.

Phase 2: TFSDeleteProject löscht Projektwebsites

In der zweiten Phase löscht TFSDeleteProject die folgenden Daten:

Wichtig

Diese Schritte können viel Zeit in Anspruch nehmen. In dieser Zeit kann die Serverleistung abnehmen.

  • TFSDeleteProjectVerwendet die Reporting Services-APIs, um Berichte auf dem Server zu löschen, der Reporting Services hostet.

  • TFSDeleteProject löscht die Projektportalwebsite vom Server, der SharePoint-Produkte hostet. Dieser Schritt tritt nur auf, wenn das Projekt die Website besitzt und die Websitelöschung nicht in der Befehlszeile ausgeschlossen ist. (Bedenken Sie, dass mehrere Projekte möglicherweise auf eine einzelne Website verweisen, aber nur eines über die Website verfügen und Berichte/Dashboards standardmäßig verwenden kann.)

    Tipp

    Vor dem Löschen eines Teamprojekts können Sie bestätigen, dass Reporting Services und SharePoint-Produkte die richtigen Projekt-URLs verwenden, indem sie die Portaleinstellungen überprüfen. Weitere Informationen finden Sie unter Hinzufügen eines Teamprojektportals .

Wenn TFSDeleteProject alle oben erwähnten Datenelemente erfolgreich löscht, gibt es die Meldung Done zurück. Um dieses Ergebnis zu überprüfen, finden Sie unter Überprüfen, ob Teamprojektkomponenten gelöscht wurden entsprechende Informationen.

Wenn eine oder mehrere Komponenten nicht entfernt werden, können Sie TFSProjectDelete mit der /force-Option erneut ausführen, um den Löschprozess fortzusetzen, auch wenn nicht alle Datenelemente gelöscht werden können. Mit dieser Option überspringt TFSDeleteProject eine Komponente, die nicht gelöscht werden kann. Anschließend wird eine Fehlermeldung zurückgegeben, die nächste Komponente wird gelöscht, und die Metadaten und Sicherheitseinstellungen des Teamprojekts bleiben unverändert.

Daten, die ungelöscht bleiben dürfen

Die folgenden Daten könnten in der Bereitstellung bleiben, nachdem TFSDeleteProject erfolgreich abgeschlossen wurde:

  • Teamprojektdaten im Cube. Teamprojektdatenüberreste bleiben im Cube, bis der Cube neu erstellt wird. Zu diesem Zeitpunkt entfernt der Warehouse-Controllerdienst alle historischen Builddaten, die aus den Team Foundation-Datenbanken gelöscht wurden.

  • Buildablagedateien und Ordner. Buildbinärdateien, Buildprotokolldateien und Protokolldateien mit Testergebnissen werden während des Erstellungsprozesses aufgerufen. Die Speicherorte für diese Dateien werden nicht gelöscht. Sie müssen die Dateien gegebenenfalls manuell entfernen.

  • Arbeitsaufgaben-Verfolgungsmetadaten, die freigegeben sind. TFSDeleteProject löscht keine Metadaten für Arbeitsaufgabenverfolgung, die zwischen Teamprojekten freigegeben ist.

  • Versionskontrollen-Shelvesets, die freigegebenen Code enthalten. Versionskontrollen-Shelvesets werden nicht gelöscht, wenn Code im Shelveset aus mehreren Teamprojekten stammt.

Überprüfen von Projektlöschungen

Sie können den erfolgreichen Verlauf einer Projektlöschung überprüfen, indem Sie sich vergewissern, dass der Teamprojektknoten nicht mehr in Team Explorer angezeigt wird, und dass die Projektportal-Website und Berichtsordner nicht mehr vorhanden sind.

So überprüfen Sie, ob ein Teamprojekt gelöscht wurde

  1. Öffnen Sie Team Explorer, und überprüfen Sie, ob das Projekt nicht als Projektknoten angezeigt wird.

  2. Öffnen Sie Internet Explorer, und geben Sie die URL der Projektportalwebsite ein. Überprüfen Sie, ob die Website nicht mehr vorhanden ist.

  3. Geben Sie in Internet Explorer im Adressfeld die URL der Reporting Services-Website in einem der folgenden URL-Formate ein:

    • http://ReportingServices/Reports

    • **http://ReportingServices/Reports_**TFSInstanz

  4. Klicken Sie im Berichts-Manager auf Details anzeigen.

  5. Überprüfen Sie, ob der Ordner für das gelöschte Teamprojekt nicht mehr angezeigt wird. Klicken Sie auf den Stammordner TfsReports und dann auf den Ordner für die Teamprojektauflistung. Es darf keinen Ordner mit dem Namen des gelöschten Projekts mehr geben.

  6. Wenn entweder die Berichte oder die Website bleibt, fahren Sie mit der nächsten Prozedur fort.

Entfernen von verbleibenden Komponenten nach unvollständigem Löschen des Projekts

Wenn Projektportalwebsite und -berichtsordner zurückbleiben, nachdem Sie ein Teamprojekt gelöscht haben, entfernen Sie Website und Ordner manuell.

So entfernen Sie manuell Berichte und die Projektportal-Website eines gelöschten Teamprojekts

  1. Melden Sie sich an dem Server an, der Reporting Services für das Teamprojekt hostet, das Sie gelöscht haben.

  2. Öffnen Sie den Internet Explorer, und geben Sie im Adressfeld die URL der Reporting Services-Website in einem der folgenden URL-Formate ein:

    • https://localhost/Reports

    • **https://localhost/Reports_**TFSInstanz

  3. Klicken Sie im Berichts-Manager auf Details anzeigen.

  4. Klicken Sie auf den Stammordner TfsReports und dann auf den Ordner für die Teamprojektauflistung.

  5. Aktivieren Sie das Kontrollkästchen für das gelöschte Teamprojekt.

  6. Klicken Sie auf Löschen.

  7. Klicken Sie auf OK, um zu bestätigen, dass Sie den Berichtsordner für das Teamprojekt löschen möchten.

  8. Wenn Sie die Projektportalwebsite eines gelöschten Teamprojekt zu entfernen möchten, finden Sie auf der folgenden Seite auf der Microsoft-Website entsprechende Informationen: How to: Create, Edit, and Delete Windows SharePoint Services Sites.

Timeout-Zeitraum vergrößern

Standardmäßig muss jeder Webdienstaufruf, den der TFSDeleteProject-Befehl ausgibt, um eine Komponente zu löschen, innerhalb von 10 Minuten abgeschlossen werden. Wenn es sechs Aufrufe gibt, kann der Prozess bis zu einer Stunde dauern. Wenn Sie ein Teamprojekt löschen möchten, das einer großen Datenmenge zugeordnet ist, können Sie dieses Timeout vorübergehend vergrößern.

Tipp

Wenn Sie das Timeout vergrößern, wirkt sich die Änderung auf alle Webdienstaufrufe aus. Im Allgemeinen sollte das Timeout nicht länger als 10 Minuten sein, damit Webdienstaufrufe die Serverleistung nicht beeinträchtigen und Benutzer nicht für lange Zeiträume von der Verwendung der Benutzeroberfläche abgehalten werden. Nachdem das Projekt erfolgreich gelöscht wurde, sollten Sie daher als Timeout-Periode wieder 10 Minuten festlegen.

Erforderliche Berechtigungen

Für die folgenden Verfahren müssen Sie als Windows-Administrator auf dem Server für die Anwendungsebene angemeldet sein.

Wichtig

Eine unsachgemäße Bearbeitung der Registrierung des Computers kann zur Folge haben, dass der Computer instabil wird. Wenn Sie mit der Registrierung nicht vertraut sind, sollten Sie keine Einträge hinzufügen bzw. entfernen oder die Registrierung auf andere Art bearbeiten.

So erhöhen Sie das Timeout für den TFSDeleteProject-Befehl

  1. Melden Sie sich beim Anwendungsebenenserver an.

  2. Klicken Sie auf Start, klicken Sie auf Ausführen, geben Sie regedit ein, und klicken Sie anschließend auf OK.

  3. Erweitern Sie im Browserfenster HKEY_ LOCAL_MACHINE.

    • Wenn der Server ein 32-Bit-Betriebssystem ausführt, erweitern Sie folgendermaßen: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\10 .0\TeamFoundation\RequestSettings.

    • Wenn der Server ein 32-Bit-Betriebssystem ausführt, erweitern Sie folgendermaßen: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\10.0\TeamFoundation\RequestSettings.

  4. Wenn der TeamFoundation\RequestSettings-Schlüssel nicht vorhanden ist, führen Sie folgende Schritte aus, um ihn zu erstellen:

    1. Klicken Sie mit der rechten Maustaste auf TeamFoundation, zeigen Sie auf Neu, und klicken Sie dann auf Schlüssel.

    2. Nennen Sie den Schlüssel RequestSettings.

    3. Klicken Sie mit der rechten Maustaste auf RequestSettings. Zeigen Sie dann auf Neu, und klicken Sie auf DWORD-Wert.

    4. Nennen Sie den neuen Wert DefaultTimeout.

  5. Klicken Sie mit der rechten Maustaste auf DefaultTimeout und wählen Sie die Option zum Ändern aus.

  6. Geben Sie in Wertdaten das Timeout in Millisekunden ein, und klicken Sie dann auf Dezimal.

    Beispiel: Um das Timeout auf 30 Minuten zu erhöhen, geben Sie 1 800 000 ein. Um als Timeout wieder eine Dauer von 10 Minuten festzulegen, geben Sie 600.000 ein.

  7. Klicken Sie auf OK.

  8. Klicken Sie im Menü Datei auf Beenden.

Beispiel

Der folgende Befehl entfernt alle dem Teamprojekt "StoreFront" auf dem Team Foundation Server-Server "AdventureWorks1" zugeordneten Komponenten in Projektsammlung "Collection1" und von Team Explorer.

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

Siehe auch

Aufgaben

Herstellen einer Verbindung mit Teamprojekten in Team Foundation Server und Zugriff auf die Teamprojekte

Erstellen eines Teamprojekts

Weitere Ressourcen

Verwalten von Berechtigungen

Konfigurieren von Ressourcen für die Unterstützung von Teamprojekten

Verwenden von Team Foundation Server-Befehlszeilentools