Delete-Befehl (Team Foundation-Versionskontrolle)

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Entfernt Dateien und Ordner vom Team Foundation-Versionskontrolle-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 Löschbefehl verwenden zu können, muss die Berechtigung Auschecken auf Zulassen festgelegt sein. Wenn Sie die Option /lock mit einem anderen Wert als none verwenden,muss die Berechtigung Sperren auf Zulassen festgelegt sein. Darüber hinaus müssen Sie den Arbeitsbereich besitzen 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

Argument

Argument

Beschreibung

Itemspec

Identifiziert die Datei oder den Ordner, die bzw. der vom Team Foundation-Versionskontrollserver gelöscht werden soll. Weitere Informationen dazu, wie Team Foundation Itemspecs analysiert, um zu bestimmen, welche Elemente innerhalb des Bereichs liegen, finden Sie unter Verwenden von Team Foundation-Befehlen zur Versionskontrolle, Verwenden von Optionen zum Ändern der Funktionsweise eines Befehls.

Hinweis

Sie können mehrere Itemspec-Argumente angeben.

username

Stellt einen Wert für die Option /login dar. Sie können einen Benutzernamenwert entweder als DOMAIN em > UserName oder >

Option

Option

Beschreibung

/lock

Verhindert, dass andere Benutzer die angegebenen Elemente ein- 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 festgelegt 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 in gesperrte Dateien einchecken, bis Sie die Sperre durch ausführen eines Eincheckens wieder aktivieren. Wenn ein anderer Benutzer eines der angegebenen Elemente gesperrt hat, schlägt der Sperrvorgang fehl.

  • Auschecken
    Verhindert, dass andere Benutzer eines der angegebenen Elemente einchecken oder auschecken, bis Sie die Sperre durch ausführen eines Eincheckens wieder aktivieren. Wenn ein anderer Benutzer eines der angegebenen Elemente gesperrt hat, schlägt der Sperrvorgang fehl.

/recursive

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

  • tf delete folder1\folder2 /recursive (wobei folder1\folder2 vorhanden ist und ein Verzeichnis ist) 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 den dateienpec in folder1\folder2 und jedem ihrer Unterverzeichnisse entspricht, sowie alle Dateien und Unterverzeichnisse, die in einem beliebigen Verzeichnis enthalten sind, das der Filespec entspricht.

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\folder2\NeverDelete\AVeryImportantFile.txt, da es dem Platzhalterzeichen entspricht.

/login

Gibt den Benutzernamen und das Kennwort zum Authentifizieren des Benutzers mit Azure DevOps.

Hinweise

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" auf dem Team Foundation-Versionskontrollserver mithilfe des Eincheckbefehls ausführen, entfernt Team Foundation das Element vom Team Foundation-Versionskontrollserver, löscht es jedoch nicht dauerhaft. Sie können gelöschte Elemente auf dem Team Foundation-Versionskontrollserver mithilfe des Dir-Befehls suchen, und Sie können gelöschte Elemente mit dem Befehl Undelete wiederherstellen wiederherstellen.

Wenn Sie ein Element in Ihrem Arbeitsbereich gelöscht, aber die Änderung nicht überprüft haben, können Sie das Element in Ihrem Arbeitsbereich wiederherstellen und den Löschvorgang mit dem Befehl Rückgängig aus der Liste der ausstehenden Änderungen entfernen.

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 mit dem Befehl rückgängig machen.

Wenn Sie einen ausstehenden Löschvorgang einchecken, markiert Team Foundation die Datei auf dem Team Foundation-Versionskontrollserver als gelöscht. Wenn Sie anschließend ein Element aus anderen Arbeitsbereichen (entweder von Ihnen oder anderen Benutzern) erhalten, wird das Element aus diesen Arbeitsbereichen gelöscht.

Wenn ihre Itemspec einen Ordner angibt, löscht Team Foundation standardmäßig alle Dateien und Unterordner sowie die dateien, die sie enthalten.

Weitere Informationen zum Suchen des Tf-Befehlszeilenprogramms finden Sie unter Verwenden von Team Foundation-Befehlen zur Versionskontrolle.

Beispiele

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

c:\projects>tf delete 314.cs