Befehl Delete (Team Foundation-Versionskontrolle)

  • Artikel

Aktualisiert: November 2007

Entfernt Dateien und Ordner vom Server für die Team Foundation-Versionskontrolle und löscht sie vom Datenträger.

Hinweis:

Die Ergebnisse dieses Befehls sind in anderen Arbeitsbereichen erst dann sichtbar, wenn Sie einen Eincheckvorgang ausführen. Weitere Informationen finden Sie unter Gewusst wie: Einchecken von ausstehenden Änderungen.

Erforderliche Berechtigungen

Zum Verwenden des delete-Befehls muss die Berechtigung Auschecken auf Zulassen festgelegt sein. Wenn Sie für die Option /lock einen anderen Wert als none angeben, muss die Berechtigung Sperren auf Zulassen festgelegt sein. Darüber hinaus müssen Sie entweder Besitzer des Arbeitsbereichs sein oder die Berechtigung Arbeitsbereiche verwalten muss auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

tf delete [/lock:(none|checkin|checkout)] [/recursive] itemspec

Parameter

Argument

Beschreibung

itemspec

Identifiziert die Datei oder den Ordner auf dem Server für die Team Foundation-Versionskontrolle. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen.

Option

Beschreibung

/lock

Verhindert, dass andere Benutzer die angegebenen Elemente ein- oder auschecken. Weitere Informationen finden Sie unter Grundlagen von Sperrentypen.

Sperroptionen:

  • None

    Standard. Es wird keine Sperre angewendet. Wenn für die angegebene Datei eine Sperre festgelegt ist, wird die Sperre mit dieser Option aufgehoben. Mit dieser Option werden keine Sperren aufgehoben, die von anderen Benutzern festgelegt wurden.

  • Checkin

    Andere Benutzer können die angegebenen Elemente auschecken, können Überarbeitungen gesperrter Dateien jedoch erst dann einchecken, wenn Sie die Sperre durch Einchecken wieder freigeben. Wenn eines oder mehrere der angegebenen Elemente durch einen anderen Benutzer gesperrt sind, ist der Sperrvorgang nicht möglich.

  • Checkout

    Verhindert das Auschecken der angegebenen Elemente durch Benutzer, bis Sie die Sperre durch das Einchecken aufheben. Wenn andere Benutzer eines der Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

/recursive

Löscht alle Dateien und/oder Ordner und Unterordner, die mit der itemspec des angegebenen Verzeichnisses übereinstimmen.

  • tf delete folder1\folder2 /recursive (wobei folder1\folder2 vorhanden ist und ein Verzeichnis darstellt) löscht alle Dateien und Unterverzeichnisse, die in folder1\folder2 enthalten sind, und auch folder1\folder2 selbst.

  • tf delete folder1\folder2\filespec* /recursive löscht alle Dateien und Unterverzeichnisse, die mit der filespec aus folder1\folder2 übereinstimmen, und die jeweilig zugehörigen Unterverzeichnisse sowie alle Dateien und Unterverzeichnisse, die in allen Verzeichnissen enthalten sind, die mit der filespec übereinstimmen.

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

    Folder1\AVeryLongDirectoryName (mit einigen Dateien) und Folder1\Folder2\AVeryImportantFile.txt

    tf delete 'Folder1\AVer*' /recursive

    löscht folder1\folder2\NeverDelete\AVeryImportantFile.txt, da dieses Verzeichnis und die Datei mit dem Platzhalterzeichen übereinstimmen.

Hinweise

Der Befehl delete zeichnet für die von Ihnen angegebenen Elemente eine ausstehende Änderung vom Typ "delete" im Arbeitsbereich auf. Wenn Sie einen Commit für eine ausstehende Änderung vom Typ "delete" auf dem Server für die Team Foundation-Versionskontrolle ausführen, indem Sie den Befehl** checkin** ausführen, entfernt Team Foundation das Element vom Server für die Team Foundation-Versionskontrolle, ohne sie dauerhaft zu löschen. Sie können gelöschte Elemente auf dem Server für die Team Foundation-Versionskontrolle mit dem Befehl Dir suchen. Mit dem Befehl Undelete können Sie gelöschte Elemente wieder herstellen.

Wenn Sie ein Element aus Ihrem Arbeitsbereich gelöscht haben, die Änderung aber noch nicht eingecheckt wurde, können Sie das Element mit dem Befehl Undo im Arbeitsbereich wiederherstellen und den Löschvorgang aus der Liste der ausstehenden Änderungen entfernen.

Sie können kein Element löschen, für das es eine weitere ausstehende Änderung gibt. Eine ausgecheckte Datei kann beispielsweise nicht gelöscht werden. Um diese Elemente zu löschen, müssen Sie die aktuell ausstehende Änderung mit dem Befehl undo rückgängig machen.

Wenn Sie einen ausstehenden Löschvorgang einchecken, markiert Team Foundation die Datei auf dem Server für die Team Foundation-Versionskontrolle als gelöscht. Wenn anschließend get für das Element in einem anderen Arbeitsbereich ausgeführt wird (durch Sie oder andere Benutzer) wird das Element aus diesem Arbeitsbereich gelöscht.

Wenn durch itemspec ein Ordner angegeben wird, löscht Team Foundation standardmäßig alle enthaltenen Dateien sowie sämtliche Unterordner mit den darin enthaltenen Dateien.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".

Beispiele

Im folgenden Beispiel wird 314.cs aus dem angegebenen lokalen Arbeitsbereichsordner gelöscht. Wenn Sie die Änderung anschließend einchecken, wird 314.c nicht dauerhaft aus dem Versionskontrollsystem gelöscht.

c:\projects>tf delete 314.cs

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Versionskontrolle über die Befehlszeile

Gewusst wie: Verschieben, Umbenennen und Löschen von Dateien und Ordnern unter Versionskontrolle

Referenz

Befehl Undelete

Befehl Undo

Befehl Dir

Weitere Ressourcen

Befehle des Befehlszeilendienstprogramms "Tf"