Share via

Befehl Rename (Team Foundation-Versionskontrolle)

  • Artikel

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.

Tipp

   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 Einchecken von ausstehenden Änderungen.

Erforderliche Berechtigungen

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

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

Parameter

Argument

Beschreibungen

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.

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

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.

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

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

/login

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

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, für das eine andere Datei mit demselben Namen hinzugefügt wurde, das nicht eingecheckt wurde, , umbenennen. Sie können jedoch kein Element umbenennen, das verzweigt, jedoch noch nicht eingecheckt wurde. Wenn Sie eine Datei mit ausstehenden Änderungen umbenennen, werden die Bearbeitungen 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 Befehlszeilenhilfsprogramms "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

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

Referenz

Befehlszeilensyntax (Versionskontrolle)

Befehl Add

Befehl Delete (Team Foundation-Versionskontrolle)

Befehl Get

Konzepte

Grundlagen von Sperrentypen

Ausstehende Änderungen

Weitere Ressourcen

Befehle des Befehlszeilenhilfsprogramms "Tf"