Freigeben über

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

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022-

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

Anmerkung

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

Voraussetzungen

Wenn Sie den Befehl delete verwenden möchten, müssen Sie die berechtigung auf Zulassenfestgelegt haben. Wenn Sie die Option /lock mit einem anderen Wert als noneeinschließen, müssen Sie die berechtigung Sperren auf Zulassenfestlegen. Sie müssen auch über den Arbeitsbereich verfügen oder über die globalen Verwalten von Arbeitsbereichen verfügen, Berechtigung auf Zulassenfestgelegt ist. 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>

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

Anmerkung

Sie können mehrere itemspec Argumente angeben.

<username>

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

Optionen

Option

Beschreibung

/lock

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

Sperroptionen:

  • none
    Vorgabe. Es wird keine Sperre angewendet. Wenn Sie eine Sperre für die angegebene Datei platziert haben, wird diese Option entfernt. 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 keine Überarbeitungen für gesperrte Dateien einchecken, bis Sie die Sperre freigeben, indem Sie ein Einchecken durchführen. 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 freigeben, indem Sie ein Einchecken durchführen. 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 dem itemspec aus dem angegebenen Verzeichnis entsprechen.

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

Beispiel: in einem Arbeitsbereich, der Folgendes enthält:

Folder1\AVeryLongDirectoryName mit einigen Dateien innerhalb 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 sie dem Wildcardzeichen entspricht.

/login

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

Bemerkungen

Der Befehl delete zeichnet eine ausstehende Änderung des Typs delete in Ihrem Arbeitsbereich für die von Ihnen angegebenen Elemente auf. Wenn Sie eine ausstehende Änderung des Typs delete mithilfe des Befehls checkin auf den Azure DevOps-Server übernehmen, entfernt TFVC das Element vom Azure DevOps-Server, löscht es jedoch nicht dauerhaft. Sie können gelöschte Elemente auf dem Azure DevOps-Server mithilfe des Befehls dir suchen und gelöschte Elemente mithilfe des Befehls Rückgängigwiederherstellen.

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 mithilfe des Befehls Rückgängigentfernen.

Sie können ein Element nicht 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 Befehls undo rückgängig machen.

Wenn Sie einen ausstehenden Löschvorgang einchecken, kennzeichnet TFVC die Datei als gelöscht im Azure DevOps-Server. Anschließend wird ein get des Elements aus anderen Arbeitsbereichen, entweder von Ihnen oder anderen Benutzern, aus diesen Arbeitsbereichen gelöscht.

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

Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.

Beispiele

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

tf delete 314.cs