Wiederherstellen des Befehls

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | VS 2017 | VS 2015 | VS 2013

Der Befehl "Wiederherstellen" stellt Elemente wieder her, die zuvor gelöscht wurden.

Hinweis

Die Ergebnisse dieses Befehls sind erst in anderen Arbeitsbereichen sichtbar, wenn Sie einen Eincheckvorgang ausführen. Weitere Informationen finden Sie unter Einchecken ausstehender Änderungen.

Erforderliche Berechtigungen

Um den Befehl undelete verwenden zu können, müssen Sie die Check out-Berechtigung auf Zulassenfestlegen. Wenn Sie die Option /lock mit einem anderen Wert als none einschließen, müssen Sie die Berechtigung Sperren auf Zulassenfestlegen. Darüber hinaus müssen Sie den Arbeitsbereich besitzen oder die globale Berechtigung Arbeitsbereiche verwalten auf Zulassenfestlegen. Weitere Informationen finden Sie unter Berechtigungen und Gruppenreferenz.

tf undelete [/noget] [/lock:(none|checkin|checkout)] 
[/recursive] itemspec[;deletionID] [/login:username,[password]]

Parameter

Argument

Argument Beschreibung
Itemspec Identifiziert die Datei oder den Ordner, die bzw. der wiederherstellen soll. Weitere Informationen dazu, wie Team Foundation Itemspecs analysiert, um zu bestimmen, welche Elemente innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Versionskontrolle).
deletionID Gibt einen eindeutigen Bezeichner an, der mehrere gelöschte Elemente mit demselben Namen eindeutig definiert.
username Stellt einen Wert für die Option /login bereit. Sie können einen Benutzernamenwert als DOMAIN*UserName* oder UserNameangeben.

Option

Option

Beschreibung

/noget

Stellt das gelöschte Element in Ihrem Arbeitsbereich wieder her und ruft dann, bis ein Eincheckvorgang abgeschlossen ist, das Element auf dem Server wieder her, ruft jedoch nicht sofort eine physische Kopie des Elements auf den Datenträger ab.

/lock

Verhindert, dass andere Benutzer die angegebenen Dateien einchecken oder auschecken. Weitere Informationen finden Sie unter Grundlegendes zu Sperrtypen.

Sperroptionen:

  • None

Standard. Es wird keine Sperre angewendet.

  • Checkin

Andere Benutzer können die angegebenen Elemente auschecken, jedoch keine Revisionen in gesperrten Dateien einchecken, bis Sie die Sperre durch Ausführen eines Eincheckens freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

  • Kasse

Verhindert, dass andere Benutzer eines der angegebenen Elemente einchecken oder auschecken, bis Sie die Sperre durch Ausführen eines Eincheckens freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

/recursive

Stellt alle Dateien und Unterordner aus dem angegebenen Verzeichnis wieder her.

/login

Gibt den Benutzernamen und das Kennwort für die Authentifizierung des Benutzers mit Visual Studio Team Foundation Server an.

Hinweise

Der Befehl Wiederherstellen des Tf-Befehlszeilenfeatures plant angegebene Dateien oder Ordner für die Wiederherstellung, bis ein Eincheckvorgang abgeschlossen ist. Außerdem werden die angegebenen Elemente vom Server auf den lokalen Datenträger abgerufen, es sei denn, Sie schließen die Option /noget explizit ein.

Wenn Dateien oder Ordner mit dem gleichen Namen aus demselben Serverordner gelöscht wurden, müssen Sie einen Wert für den parameter deletionID einfügen, um anzugeben, welches der gelöschten Elemente wiederhergestellt werden soll. Sie können eine deletionID mit dem Befehl dir abrufen.

Wenn Sie die Datei nach der Wiederherstellung ändern möchten, können Sie die Datei wie gewohnt mit dem Befehl checkout bearbeiten.

Wenn Ihre Itemspec einen Ordner angibt, stellt Team Foundation standardmäßig alle zugehörigen Dateien und Unterordner sowie die darin enthaltenen Dateien wieder her. Wenn Sie nicht alle Elemente in einem Ordner wiederherstellen möchten, müssen Sie zuerst den Ordner und dessen Elemente wiederherstellen und dann die Elemente löschen, die Sie nicht beibehalten möchten.

Weitere Informationen zum Suchen des Befehlszeilenprogramms tf finden Sie unter Tf Command-Line-Hilfsprogrammbefehle.

Beispiele

Im folgenden Beispiel wird 314.cs im Serverordner wiederhergestellt, aus dem 314.cs gelöscht wurde, und eine schreibgeschützte Kopie der neuesten Version im aktuellen Arbeitsbereich abgerufen.

C:\projects>tf undelete c:\math\314.cs

Im folgenden Beispiel werden Lösch-IDs für alle 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 X11-Version von 314.cs im Serverordner wiederhergestellt, aus dem die Datei gelöscht wurde, und eine schreibgeschützte Kopie der neuesten Version im aktuellen Arbeitsbereich abgerufen.

c:\projects>tf undelete 314.cs;X11

Weitere Informationen

Referenz

Befehlszeilensyntax (Versionskontrolle)

Befehl "Umbenennen" (Team Foundation-Versionskontrolle)

Delete-Befehl

Dir-Befehl

Konzepte

Ausstehende Änderungen

Grundlegendes zu Sperrtypen

Weitere Ressourcen

Tf Command-Line-Hilfsprogrammbefehle