Befehl Delete (Team Foundation-Versionskontrolle)

Artikel
08/10/2011

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

Tipp

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

Erforderliche Berechtigungen

Damit Sie den Befehl delete verwenden können, müssen Sie über die Berechtigung Auschecken verfügen. 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 Besitzer des Arbeitsbereichs sein oder über die globale Berechtigung Arbeitsbereiche verwalten verfügen. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.

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

Parameter

Argument	Beschreibungen
itemspec	Identifiziert die Datei oder den Ordner auf dem Server für die Team Foundation-Versionskontrolle. Weitere Informationen zum Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen. Hinweis Sie können mindestens ein Itemspec-Argument angeben.
username	Gibt einen Wert für die /login-Option an. Sie können als Wert für einen Benutzernamen entweder DOMÄNE\Benutzername oder Benutzername angeben.

Option	Beschreibungen
/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. Sie können Revisionen gesperrter Dateien jedoch erst dann einchecken, wenn Sie die Sperre durch einen Eincheckvorgang wieder aufheben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl. Checkout Verhindert das Ein- oder Auschecken von einem der angegebenen Elemente durch andere Benutzer, bis die Sperre durch einen Eincheckvorgang aufgehoben wird. 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 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.
/login	Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an.

/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. Sie können Revisionen gesperrter Dateien jedoch erst dann einchecken, wenn Sie die Sperre durch einen Eincheckvorgang wieder aufheben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.
Checkout

Verhindert das Ein- oder Auschecken von einem der angegebenen Elemente durch andere Benutzer, bis die Sperre durch einen Eincheckvorgang aufgehoben wird. 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 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.

/login

Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an.

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 eine weitere ausstehende Änderung vorhanden ist. Beispielsweise können ausgecheckte Dateien 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 Befehlszeilenhilfsprogramms "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

Befehl Delete (Team Foundation-Versionskontrolle)

Parameter

Hinweise

Beispiele

Siehe auch

Aufgaben

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen