Delete-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Der delete-Befehl entfernt Dateien und Ordner vom Azure DevOps-Server und löscht sie vom Datenträger.

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

Um den delete-Befehl zu verwenden, müssen Sie die Auscheckberechtigung auf Zulassen festlegen. Wenn Sie die /lock-Option mit einem anderen Wert als none angeben, müssen Sie die Berechtigung Sperren auf Zulassen festlegen. Sie müssen auch Besitzer des Arbeitsbereichs sein oder die globale Berechtigung Arbeitsbereiche verwalten auf Zulassen festgelegt haben. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

tf delete [/lock:(none|checkin|checkout)] [/recursive] [/login:username,[password]] itemspec

Parameter

Argumente

Argument

Beschreibung

<itemspec>

Identifiziert die zu löschende Datei oder den zu löschenden Ordner auf dem Azure DevOps-Server. Weitere Informationen darüber, wie TFVC eine itemspec analysiert, um festzustellen, welche Elemente im Gültigkeitsbereich liegen, finden Sie unter Verwenden von Optionen zum Ändern der Funktionsweise eines Befehls.

Hinweis

Sie können mehr als ein itemspec-Argument angeben.

<username>

Stellt einen Wert für die Option /login bereit. Sie können einen Benutzernamen entweder als DOMAIN\username oder als username angeben.

Tastatur

Option

Beschreibung

/lock

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

Sperroptionen:

  • none
    Standard. Es wird keine Sperre angewendet. Wenn Sie die angegebene Datei mit einer Sperre versehen haben, können Sie diese mit dieser Option entfernen. Es wird keine Sperre entfernt, die von einer anderen Person platziert wurde.

  • checkin
    Andere Benutzer können die angegebenen Elemente auschecken, aber sie können Revisionen für gesperrte Dateien erst einchecken, wenn Sie die Sperre durch Ausführen eines Eincheckvorgangs freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, tritt beim Sperrvorgang ein Fehler auf.

  • checkout
    Verhindert, dass andere Benutzer die angegebenen Elemente ein- oder auschecken, bis Sie die Sperre durch einen Eincheckvorgang freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, tritt beim Sperrvorgang ein Fehler auf.

/recursive

Löscht alle Dateien und/oder Ordner und Unterordner, die mit itemspec übereinstimmen, aus dem angegebenen Verzeichnis.

  • tf delete <folder1>\<folder2> /recursive löscht alle Dateien und Unterverzeichnisse, die in <folder1>\<folder2> enthalten sind, sowie <folder1>\<folder2> selbst.
  • tf delete <folder1>\<folder2> <filespec> /recursive löscht alle Dateien und Unterverzeichnisse, die mit filespec übereinstimmen, die in <folder1>\<folder2> und jedem seiner Unterverzeichnisse enthalten sind, sowie alle Dateien und Unterverzeichnisse, die in einem Verzeichnis enthalten sind, das mit filespec übereinstimmt.

Beispielsweise in einem Arbeitsbereich, der Folgendes enthält:

Folder1\AVeryLongDirectoryName mit einigen Dateien darin und Folder1\Folder2\AVeryImportantFile.txt

tf delete Folder1 AVer* /recursive

löscht Folder1\AVeryLongDirectoryName und alle darin enthaltenen Dateien und löscht Folder1\Folder2\AVeryImportantFile.txt, da dies mit dem Platzhalterzeichen übereinstimmt.

/login

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

Bemerkungen

Der delete-Befehl zeichnet eine ausstehende Änderung des Typs delete in Ihrem Arbeitsbereich für die Elemente auf, die Sie angeben. Wenn Sie eine ausstehende Änderung des Typs delete mithilfe des checkin-Befehls für den Azure DevOps-Server committen, entfernt TFVC das Element vom Azure DevOps-Server, löscht es aber nicht dauerhaft. Sie können gelöschte Elemente auf dem Azure DevOps-Server mithilfe des dir-Befehls ermitteln und gelöschte Elemente mithilfe des Undelete-Befehls wiederherstellen.

Wenn Sie ein Element in Ihrem Arbeitsbereich gelöscht, die Änderung aber nicht eingecheckt haben, können Sie das Element in Ihrem Arbeitsbereich wiederherstellen und den Löschvorgang aus der Liste der ausstehenden Änderungen entfernen, indem Sie den Undo-Befehl verwenden.

Sie können kein Element löschen, für das eine andere ausstehende Änderung vorhanden ist. Beispielsweise kann eine ausgecheckte Datei nicht gelöscht werden. Um solche Elemente zu löschen, müssen Sie die aktuelle ausstehende Änderung mithilfe des undo-Befehls rückgängig machen.

Wenn Sie einen ausstehenden Löschvorgang einchecken, markiert TFVC die Datei auf dem Azure DevOps-Server als gelöscht. Wenn anschließend ein get für das Element aus anderen Arbeitsbereichen ausgeführt wird, entweder von Ihnen oder von anderen Benutzern, wird das Element aus diesen Arbeitsbereichen gelöscht.

Wenn Ihre itemspec einen Ordner angibt, löscht TFVC standardmäßig alle zugehörigen Dateien und Unterordner sowie die darin enthaltenen Dateien.

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

Beispiele

Im folgenden Beispiel wird 314.cs auf dem Datenträger im angegebenen lokalen Arbeitsbereichsordner gelöscht, und wenn Sie die Änderung einchecken, wird 314.cs nicht dauerhaft aus dem Versionskontrollsystem entfernt.

tf delete 314.cs