Delete-Befehl (Team Foundation-Versionskontrolle)
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 mitfilespec
übereinstimmen, die in <folder1>\<folder2> und jedem seiner Unterverzeichnisse enthalten sind, sowie alle Dateien und Unterverzeichnisse, die in einem Verzeichnis enthalten sind, das mitfilespec
ü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