Befehl Rename (Team Foundation-Versionskontrolle)

  • Artikel

Aktualisiert: November 2007

Der Befehl rename ändert den Namen oder den Pfad einer Datei oder eines Ordners. Sie können den Befehl rename oder die Aliase move oder ren für das Verschieben einer Datei oder eines Ordners an einen neuen Speicherort verwenden.

Hinweis:

Die Ergebnisse dieses Befehls werden erst nach dem Ausführen eines Eincheckvorgangs im Server für die Team Foundation-Versionskontrolle widergespiegelt. Weitere Informationen finden Sie unter Gewusst wie: Einchecken von ausstehenden Änderungen.

Erforderliche Berechtigungen

Zum Verwenden des rename-Befehls muss die Berechtigung Auschecken auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

tf rename [/lock:(none|checkout|checkin)] olditem newitem

Parameter

Argument

Beschreibung

olditem

Der ursprüngliche Name und Pfad der Datei oder des Ordners, die bzw. der umbenannt werden soll. Sie können einen lokalen Arbeitsbereichspfad wie C:\myfiles\314.cs oder einen Pfad auf dem Server für die Team Foundation-Versionskontrolle wie $/myfiles/314.cs angeben.

newitem

Der neue Name der Datei oder des Ordners. Sie können mit diesem einen anderen Speicherort oder einen Pfad auf dem Server für die Team Foundation-Versionskontrolle angeben.

Option

Beschreibung

/lock

Fügen Sie diese Option ein, um zu verhindern, dass andere Benutzer die angegebenen Elemente ein- bzw. auschecken. Wenn diese Option nicht angegeben wurde, wird der vorhandene Sperrstatus des Elements nicht geändert. Weitere Informationen finden Sie unter Grundlagen von Sperrentypen.

Sperroptionen:

  • None   Es wird keine Sperre angewendet.

  • 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.

Hinweise

Sie können mit dem Befehl rename des Befehlszeilenprogramms tf ein Element, das der Versionskontrolle unterliegt, in Ihrem Arbeitsbereich verschieben oder umbenennen. Verwenden Sie den rename-Befehl, um mehrere Dateien durch die Angabe von Platzhalterzeichen zu verschieben. Die Möglichkeit zum Umbenennen mehrerer der Versionskontrolle unterliegenden Dateien oder Ordner besteht nur in der Befehlszeile.

Verwenden Sie Rename für folgende Vorgänge:

  • Umbenennen von olditem in newitem, z. B. tf rename 314.cs 315.cs.

  • Verschieben Sie olditem an einen neuen Speicherort auf dem Server für die Team Foundation-Versionskontrolle, indem Sie ein newitem angeben, dessen Pfadangabe sich von der von olditem unterscheidet, z. B. ** **tf rename 314.cs ..\newdir\314.cs.

Wenn Sie ein newitem in einem nicht vorhandenen Ordner angeben, wird der Zielordner durch den Befehl rename erstellt. Wenn newitem ein Ordner ist, wird olditem ein untergeordnetes Element von newitem.

In folgenden Fällen können Sie ein Element nicht umbenennen:

  • Sie haben es gelöscht, bevor es in denselben Arbeitsbereich eingecheckt wurde.

  • Der neue Name ist bereits auf dem Server für die Team Foundation-Versionskontrolle vorhanden und kein Ordner.

  • Sie haben das Element, dessen Einchecken noch aussteht, bereits hinzugefügt, verzweigt oder umbenannt.

  • Das Element ist im Arbeitsbereich zugeordnet, aber auf dem lokalen Datenträger nicht verfügbar.

  • Das Element ist verdeckt.

Sie können ein Element umbenennen, für das eine andere Datei mit demselben Namen hinzugefügt wurde, deren Einchecken aber noch aussteht. Sie können aber kein Element umbenennen, das verzweigt, aber nicht eingecheckt wurde. Wenn Sie eine Datei mit ausstehenden Änderungen umbenennen, werden diese Änderungen beibehalten.

Ein explizit zugeordnetes Element kann nicht umbenannt werden, ohne zunächst die Zuordnung zu ändern. Wenn beispielsweise ein Arbeitsordner von $/ProjektX/MyApp auf c:\MyApp zugeordnet ist, können Sie MyApp nicht umbenennen. Sie können Unterelemente von MyApp umbenennen, jedoch nicht MyApp selbst.

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

Beispiele

Im folgenden Beispiel wird der Name von 314.c in 1254.c geändert.

c:\projects>tf rename  314.c  1254.c

Im folgenden Beispiel wird 314.c in 1254.c umbenannt und in den Ordner newdir verschoben.

c:\projects>tf rename 314.c ..\newdir\1254.c

Im folgenden Beispiel wird der Name von Form1.vb in MainPage.vb geändert und eine Sperre darauf angewendet.

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin

Siehe auch

Aufgaben

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

Konzepte

Grundlagen von Sperrentypen

Ausstehende Änderungen

Referenz

Befehlszeilensyntax (Team System)

Befehl Add

Befehl Delete (Team Foundation-Versionskontrolle)

Befehl Get

Weitere Ressourcen

Befehle des Befehlszeilendienstprogramms "Tf"