Befehl "Löschen" (Team Foundation-Versionskontrolle)

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

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 erst in anderen Arbeitsbereichen sichtbar, wenn Sie einen Eincheckvorgang ausführen. Weitere Informationen finden Sie unter Entwickeln von Code und Verwalten ausstehender Änderungen.

Voraussetzungen

Um den delete Befehl verwenden zu können, muss die Berechtigung Auschecken auf Zulassen festgelegt sein. Wenn Sie die /lock Option mit einem anderen Wert als noneeinschließen, muss die Berechtigung Sperren auf Zulassen festgelegt sein. Sie müssen auch den Besitz des Arbeitsbereichs besitzen oder die globale Berechtigung Arbeitsbereiche verwalten auf Zulassen festgelegt haben. Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.

Syntax

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

Parameter

Argumente

Argument

Beschreibung

<itemspec>

Gibt die Datei oder den Ordner an, die vom Azure DevOps-Server gelöscht werden soll. Weitere Informationen dazu, wie TFVC einen itemspec analysiert, um zu ermitteln, welche Elemente innerhalb des Bereichs liegen, finden Sie unter Verwenden von Optionen zum Ändern der Funktionsweise eines Befehls.

Hinweis

Sie können mehrere itemspec Argumente angeben.

<username>

Stellt der Option einen Wert bereit /login . Sie können einen Benutzernamenwert als oder DOMAIN\usernameusernameangeben.

Tastatur

Option

Beschreibung

/lock

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

Sperroptionen:

  • none
    Standard. Es wird keine Sperre angewendet. Wenn Sie eine Sperre für die angegebene Datei platziert haben, wird sie durch diese Option entfernt. Eine von einer anderen Person platzierte Sperre wird nicht entfernt.

  • checkin
    Andere Benutzer können die angegebenen Elemente auschecken, aber sie können keine Revisionen für gesperrte Dateien einchecken, bis Sie die Sperre durch ein Einchecken freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

  • checkout
    Verhindert, dass andere Benutzer eines der angegebenen Elemente einchecken oder auschecken, bis Sie die Sperre durch ein Einchecken freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

/recursive

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

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

Beispielsweise in einem Arbeitsbereich, der Folgendes enthält:

Folder1\AVeryLongDirectoryName mit einigen Dateien in und Folder1\Folder2\AVeryImportantFile.txt,

tf delete Folder1 AVer* /recursive

löscht Folder1\AVeryLongDirectoryName und alle zugehörigen Dateien und löscht Folder1\Folder2\AVeryImportantFile.txt , da es mit dem Feldhalterzeichen übereinstimmt.

/login

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

Bemerkungen

Der delete Befehl zeichnet eine ausstehende Typänderung delete in Ihrem Arbeitsbereich für die von Ihnen angegebenen Elemente auf. Wenn Sie mithilfe des Befehls einen Commit für eine ausstehende Typänderung delete auf den checkin Azure DevOps-Server ausführen, entfernt TFVC das Element vom Azure DevOps-Server, löscht es jedoch nicht endgültig. Sie können gelöschte Elemente auf dem Azure DevOps-Server mithilfe des dir Befehls suchen, und Sie können gelöschte Elemente mithilfe des Befehls Undelete wiederherstellen.

Wenn Sie ein Element in Ihrem Arbeitsbereich gelöscht, die Änderung jedoch nicht aktiviert haben, können Sie das Element in Ihrem Arbeitsbereich wiederherstellen und das Löschen aus der Liste der ausstehenden Änderungen entfernen, indem Sie den Befehl Rückgängig verwenden.

Sie können kein Element löschen, für das eine weitere 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 Sie anschließend ein get Element aus anderen Arbeitsbereichen ausführen, entweder durch Sie oder andere Benutzer, löscht das Element aus diesen Arbeitsbereichen.

Wenn Sie itemspec einen Ordner angeben, löscht TFVC standardmäßig alle Dateien und Unterordner sowie die darin enthaltenen Dateien.

Weitere Informationen zur Verwendung des Befehlszeilenprogramms finden Sie unter Verwenden vontf Team Foundation-Versionssteuerungsbefehlen.

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