Undelete-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Der undelete-Befehl der Team Foundation-Versionskontrolle (TFVC) stellt Elemente wieder her, die zuvor gelöscht wurden.

Hinweis

Die Ergebnisse dieses Befehls sind in anderen Arbeitsbereichen erst sichtbar, wenn Sie einen Eincheckvorgang durchführen. Weitere Informationen finden Sie unter Entwickeln von Code und Verwalten ausstehender Änderungen.

Voraussetzungen

So verwenden Sie den undelete-Befehl

  • Sie müssen die Berechtigung Auschecken auf Zulassen festgelegt haben.
  • Wenn Sie die /lock-Option mit einem anderen Wert als None angeben, müssen Sie die Berechtigung Sperren auf Zulassen festlegen.
  • Sie müssen Besitzer des Arbeitsbereichs sein oder die globale Berechtigung Arbeitsbereiche verwalten auf Zulassen festgelegt haben.

Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

tf undelete [/noget] [/lock:(none|checkin|checkout)] 
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]

Parameter

In den folgenden Abschnitten werden Argumente und Optionen des undelete-Befehls beschrieben.

Argumente

Argument BESCHREIBUNG
<item-specification> Identifiziert die wiederherzustellende Datei oder den wiederherzustellenden Ordner. Weitere Informationen dazu, wie TFVC <item-specification>-Werte analysiert, um zu bestimmen, welche Elemente im Gültigkeitsbereich liegen, finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.
<deletion-ID> Gibt einen eindeutigen Bezeichner an, der mehrere gelöschte Elemente, die denselben Namen haben, eindeutig zuordnen kann.
<username> Stellt einen Wert für die Option /login bereit. Sie können diesen Wert als DOMAIN\<username> oder <username> angeben.

Tastatur

Option

Beschreibung

/noget

Stellt das gelöschte Element in Ihrem Arbeitsbereich wieder her. In Erwartung des Abschlusses eines Eincheckvorgangs stellt diese Option das Element auf dem Server wieder her, ruft aber nicht sofort eine physische Kopie des Elements auf dem Datenträger ab.

/lock

Hindert andere Benutzer daran, die angegebenen Dateien ein- oder auszuchecken. Weitere Informationen finden Sie unter Grundlegendes zu Sperrtypen.

Sperroptionen:

  • None: Diese Option ist der Standardwert. Es wird keine Sperre angewendet.
  • Checkin: Andere Benutzer können die angegebenen Elemente auschecken, aber sie können keine Revisionen von gesperrten Dateien einchecken, bis Sie die Sperre aufheben, indem Sie die gesperrten Dateien einchecken. Wenn ein anderer Benutzer eines der angegebenen Elemente gesperrt hat, tritt beim Sperrvorgang ein Fehler auf.
  • Checkout: Diese Option verhindert, dass andere Benutzer eines der angegebenen Elemente ein- oder auschecken können, bis Sie die Sperre durch Einchecken der gesperrten Dateien aufheben. Wenn ein anderer Benutzer eines der angegebenen Elemente gesperrt hat, tritt beim Sperrvorgang ein Fehler auf.

/recursive

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

/login

Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.

Bemerkungen

Der undelete-Befehl des tf-Befehlszeilenfeatures plant die Wiederherstellung von bestimmten Dateien oder Ordnern in Abhängigkeit vom Abschluss eines Eincheckvorgangs. Er ruft auch die angegebenen Elemente vom Server auf den lokalen Datenträger ab, sofern Sie nicht ausdrücklich die Option /noget angeben.

Wenn Dateien oder Ordner mit demselben Namen aus demselben Serverordner gelöscht wurden, müssen Sie einen Wert für den <deletion-ID>-Parameter eingeben, um anzugeben, welches der gelöschten Elemente Sie wiederherstellen möchten. Sie können eine <deletion-ID> mithilfe des dir-Befehls abrufen.

Wenn Sie eine Datei nach der Wiederherstellung ändern möchten, checken Sie die Datei zur Bearbeitung aus, indem Sie wie gewohnt den checkout-Befehl verwenden.

Wenn Ihr <item-specification>-Wert einen Ordner angibt, stellt TFVC standardmäßig alle Dateien und Unterordner des Ordners sowie die darin enthaltenen Dateien wieder her. Wenn Sie nicht alle Elemente in einem Ordner wiederherstellen möchten, müssen Sie zunächst den Ordner und seine Elemente wiederherstellen und dann die Elemente löschen, die Sie nicht behalten möchten.

Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Beispiele

Im folgenden Beispiel wird 314.cs in dem Serverordner wiederhergestellt, aus dem 314.cs gelöscht wurde. Der Befehl ruft auch eine schreibgeschützte Kopie der neuesten Version im aktuellen Arbeitsbereich ab.

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

Im folgenden Beispiel werden die Lösch-IDs für alle Elemente auf dem Server angezeigt, die mehr als einmal gelöscht wurden:

c:\projects>tf dir $/ /deleted

Die Ausgabe des vorherigen Befehls könnte wie das folgende Beispiel aussehen:

$/projects/math/314.cs;X10
$/projects/math/314.cs;X11

Das folgende Beispiel stellt die X11-Version von 314.cs in dem Serverordner wieder her, aus dem die Datei gelöscht wurde. Der Befehl ruft auch eine schreibgeschützte Kopie der neuesten Version im aktuellen Arbeitsbereich ab.

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