Permanentes Entfernen von Arbeitsaufgaben [witadmin]

Mit dem Team Foundation-Befehl können ein oder mehrere Arbeitsaufgaben für eine Teamprojektauflistung endgültig aus der witadmin destroywi-Datenbank entfernt werden. Arbeitsaufgaben, deren Zustand auf "Geschlossen" festgelegt wurde, verbleiben in der Datenbank und können erneut aktiviert werden. Permanent entfernte Arbeitsaufgaben werden aus der Datenbank entfernt und können nicht wiederhergestellt oder reaktiviert werden.

Jede Arbeitsaufgabe stellt ein Objekt dar, das in der Team Foundation-Datenbank gespeichert wird und dem ein eindeutiger Bezeichner zugewiesen wird, der als Arbeitsaufgaben-ID bezeichnet wird. Arbeitsaufgaben-IDs sind innerhalb einer Projektauflistung eindeutig.

Das witadmin-Befehlszeilentool funktioniert nur, wenn dieses für einen lokalen TFS ausgeführt wird. Sie führen dieses Tool aus, indem Sie ein Eingabeaufforderungsfenster öffnen, wo entweder Visual Studio oder Team Explorer installiert ist, und Folgendes eingeben:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

Ersetzen Sie bei einer 32-Bit-Windows-Edition %programfiles(x86)% durch %programfiles%.

Anforderungen

• Sie müssen Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder Mitglied der Sicherheitsgruppe Projektadministratoren für die Teamprojektauflistung sein. Informationen finden Sie unter Berechtigungsreferenz für Team Foundation Server.

Hinweis

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.Um ein Fenster für Eingabeaufforderungen mit erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü Eingabeaufforderung, und wählen Sie anschließend Als Administrator ausführen aus.Weitere Informationen finden Sie auf dieser Microsoft-Website.

witadmin destroywi /collection:CollectionURL /id:id [/noprompt]

Parameter

Parameter	Beschreibung
/collection:CollectionURL	Gibt den URI der Teamprojektauflistung an. Der URI hat folgendes Format: http://Servername:Port/VirtuellerVerzeichnisname/Auflistungsname Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://Servername:Port/Auflistungsname
/id:id	Die ID einer zu zerstörenden Arbeitsaufgabe. Um mehrere Arbeitsaufgaben anzugeben, trennen Sie IDs nur mit Kommas (ohne Leerzeichen).
/noprompt	Deaktiviert die Eingabeaufforderung zur Bestätigung.
/? oder help	Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Beispiele

Permanentes Entfernen von Arbeitsaufgaben aus der Datenbank

Im folgenden Beispiel wird die Arbeitsaufgabe 2003 aus der Datenbank für Collection1 auf dem Server AdventureWorksServer gelöscht:

witadmin destroywi /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /id:2003

Im folgenden Beispiel werden die Arbeitsaufgaben mit den IDs 12, 15 und 23 aus der Datenbank für Collection1 auf dem Server AdventureWorksServer gelöscht:

witadmin destroywi /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /id:12,15,23

Siehe auch

Konzepte

Verwenden von Arbeitsaufgaben zum Verwalten eines Projekts

Weitere Ressourcen

witAdmin: Anpassen und Verwalten von Objekten für die Arbeitsnachverfolgung