Rename-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Der rename-Befehl der Team Foundation-Versionskontrolle (TFVC) ändert den Namen oder Pfad einer Datei oder eines Ordners. Sie können den rename-Befehl oder die Aliase move oder ren verwenden, um eine Datei oder einen Ordner an einen neuen Speicherort zu verschieben.

Hinweis

Die Ergebnisse dieses Befehls werden erst auf dem Server widergespiegelt, wenn Sie einen Check-In-Vorgang ausführen. Weitere Informationen finden Sie unter Entwickeln von Code und Verwalten ausstehender Änderungen.

Voraussetzungen

Um den rename-Befehl zu verwenden, müssen Sie die Auscheckberechtigung auf Zulassen festlegen. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

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

Parameter

Argumente

Argument

Beschreibung

<olditem>

Der ursprüngliche Name und Pfad der umzubenennenden Datei oder des Ordners. Sie können einen lokalen Arbeitsbereichpfad wie C:\myfiles\314.cs oder einen TFVC-Serverpfad wie $/myfiles/314.cs angeben.

<newitem>

Der neue Name der Datei oder des Ordners. Sie können diese Angabe verwenden, um einen anderen lokalen oder TFVC-Serverpfad anzugeben.

<username>

Stellt einen Wert für die /login-Option bereit. Sie können einen Benutzernamenwert als DOMAIN\username oder username angeben.

Tastatur

Option

Beschreibung

/lock

Schließen Sie diese Option ein, um zu verhindern, dass andere Benutzer die angegebenen Elemente ein- oder auschecken. Wenn diese Option nicht angegeben wird, wird der vorhandene Sperrstatus des Elements nicht geändert. Weitere Informationen finden Sie unter Grundlegendes zu Sperrtypen.

Sperroptionen:

  • None: Es wird keine Sperre angewendet.
  • Checkin: Andere Benutzer können die angegebenen Elemente auschecken, aber sie können Revisionen für gesperrte Dateien erst einchecken, wenn Sie die Sperre durch Ausführen eines Check-Ins freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, tritt beim Sperrvorgang ein Fehler auf.
  • Checkout: Verhindert, dass andere Benutzer die angegebenen Elemente ein- oder auschecken, bis Sie die Sperre durch einen Check-In-Vorgang freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, tritt beim Sperrvorgang ein Fehler auf.

/login

Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.

Bemerkungen

Sie können den rename-Befehl des Befehlszeilenhilfsprogramms tf verwenden, um ein Element in Ihrem Arbeitsbereich zu verschieben oder umzubenennen, das der Versionskontrolle unterliegt. Verwenden Sie den rename-Befehl, um mehrere Dateien zu verschieben, indem Sie Platzhalterzeichen angeben. Die Möglichkeit, mehrere Dateien oder Ordner umzubenennen, die der Versionskontrolle unterliegen, ist nur über die Befehlszeile verfügbar.

Verwenden Sie den rename-Befehl, um die folgenden Aktionen auszuführen:

  • Umbenennen des olditem in newitem, z. B. tf rename 314.cs 315.cs.
  • Verschieben des olditem an einen neuen Speicherort auf dem TFVC-Server, indem Sie ein newitem angeben, dessen Pfad sich von dem des olditem unterscheidet, z. B. tf rename 314.cs ..\newdir\314.cs.

Wenn Sie ein newitem angeben, das einen nicht vorhandenen Ordner angibt, erstellt der rename-Befehl den Zielordner. Wenn newitem ein Ordner ist, wird olditem ein untergeordnetes Element von newitem.

Sie können ein Element nicht umbenennen, wenn Folgendes zutrifft:

  • Sie haben es bereits gelöscht, bevor es im selben Arbeitsbereich eingecheckt wurde.
  • Der neue Name ist bereits auf dem TFVC-Server vorhanden und bezeichnet keinen Ordner.
  • Sie haben den ausstehenden Check-In-Vorgang des Elements bereits hinzugefügt, gebrancht oder umbenannt.
  • Das Element wird im Arbeitsbereich zugeordnet, ist aber nicht auf dem lokalen Datenträger verfügbar.
  • Das Element ist verdeckt.

Sie können ein Element umbenennen, für das eine andere Datei mit demselben Namen und ausstehendem Check-In hinzugefügt wurde. Sie können jedoch kein Element umbenennen, das gebrancht, aber noch nicht eingecheckt wurde. Wenn Sie eine Datei umbenennen, die ausstehende Bearbeitungen aufweist, werden die Bearbeitungen beibehalten.

Ein Element, das explizit zugeordnet ist, kann nicht umbenannt werden, ohne zuvor die Zuordnung zu ändern. Wenn beispielsweise eine Arbeitsordnerzuordnung von $/ProjectX/MyApp zu c:\MyApp vorhanden ist, können Sie MyApp nicht umbenennen. Sie können Elemente unter MyApp umbenennen, aber nicht MyApp selbst.

Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Beispiele

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

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

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

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

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

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