Befehl Undelete
Aktualisiert: November 2007
Mit dem Befehl undelete werden Elemente wiederhergestellt, die zuvor gelöscht wurden.
.gif "Hinweis") Hinweis: |
|---|
Die Ergebnisse dieses Befehls sind in anderen Arbeitsbereichen erst dann sichtbar, wenn Sie einen Eincheckvorgang ausführen. Weitere Informationen finden Sie unter Gewusst wie: Einchecken von ausstehenden Änderungen. |
Erforderliche Berechtigungen
Damit Sie den Befehl undelete verwenden können, müssen Sie über die Berechtigung Auschecken verfügen. Wenn Sie für die Option /lock einen Wert angeben möchten, müssen Sie für die Berechtigung Sperren zugelassen sein. Darüber hinaus müssen Sie Besitzer des Arbeitsbereichs sein oder über die globale Berechtigung Arbeitsbereiche verwalten verfügen. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
tf undelete [/noget] [/lock:(none|checkin|checkout)] [/newname:name]
[/recursive] itemspec[;deletionID]
Parameter
Argument |
Beschreibung |
|---|---|
name |
Der vom Benutzer angegebene Wert für die /newname-Option. Sie können entweder einen lokalen Pfad oder einen Serverpfad angeben. |
itemspec |
Identifiziert die wiederherzustellende Datei oder den Ordner. Weitere Informationen zum Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Team System). |
deletionID |
Gibt einen eindeutigen Bezeichner an, mit dem mehrere gelöschte Elemente mit demselben Namen unterschieden werden können. |
Option |
Beschreibung |
|---|---|
/noget |
Stellt das gelöschte Element im Arbeitsbereich wieder her und anschließend auf dem Server, da noch kein Eincheckvorgang abgeschlossen wurde, wobei aber nicht sofort eine physische Kopie des Elements auf den Datenträger abgerufen wird. |
/lock |
Verhindert, dass andere Benutzer die angegebenen Dateien ein- oder auschecken. Weitere Informationen finden Sie unter Grundlagen von Sperrentypen. Sperroptionen:
|
/newname |
Benennt das Element beim Wiederherstellen um. |
/recursive |
Stellt alle Dateien und Unterordner im angegebenen Verzeichnis wieder her. |
Hinweise
Der Befehl Undelete des Befehlszeilenfeatures tf erstellt einen Zeitplan für das Wiederherstellen angegebener Dateien und Ordner bei noch ausstehendem Abschluss eines Eincheckvorgangs. Außerdem werden die angegebenen Elemente vom Server auf den lokalen Datenträger abgerufen, sofern Sie nicht explizit die Option /noget angeben.
Wenn Dateien oder Ordner mit identischen Namen in demselben Serverordner gelöscht wurden, müssen Sie einen Wert für den deletionID-Parameter festlegen, um anzugeben, welches der gelöschten Elemente Sie wiederherstellen möchten. Sie können die deletionID mithilfe des Befehls dir abrufen.
Um ein Element in einem Serverordner wiederherzustellen, in dem bereits ein Element mit demselben Namen vorhanden ist oder dessen Hinzufügen aussteht, können Sie mit der Option /newname einen neuen Namen für das wiederherzustellende Element angeben. Sie können mit der Option /newname jeweils nur ein Element wiederherstellen.
Wenn Sie die Datei nach dem Wiederherstellen bearbeiten möchten, können Sie sie wie gewohnt mit dem Befehl checkout für die Bearbeitung auschecken.
Wenn durch itemspec ein Ordner angegeben wird, stellt Team Foundation standardmäßig alle enthaltenen Dateien sowie sämtliche Unterordner mit den darin enthaltenen Dateien wieder her. Wenn Sie nicht alle Elemente in einem Ordner wiederherstellen möchten, müssen Sie zunächst den Ordner mit seinen Elementen wiederherstellen und dann die nicht benötigten Elemente wieder löschen.
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".
Beispiele
Im folgenden Beispiel wird die Datei 314.cs in dem Serverordner, in dem sie gelöscht wurde, wiederhergestellt. Anschließend wird eine schreibgeschützte Kopie der letzten Version im aktuellen Arbeitsbereich abgerufen.
C:\projects>tf undelete c:\math\314.cs
Im folgenden Beispiel werden die Lösch-IDs sämtlicher Elemente auf dem Server angezeigt, die mehr als einmal gelöscht wurden.
c:\projects>tf dir $/ /deleted
Beispielausgabe:
$/projects/math/314.cs;X10 $/projects/math/314.cs;X11
Im folgenden Beispiel wird die Version X11 der Datei 314.cs in dem Serverordner, in dem sie gelöscht wurde, wiederhergestellt. Anschließend wird eine schreibgeschützte Kopie der letzten Version im aktuellen Arbeitsbereich abgerufen.
c:\projects>tf undelete 314.cs;X11
Siehe auch
Konzepte
Referenz
Befehlszeilensyntax (Team System)
Befehl Rename (Team Foundation-Versionskontrolle)