Freigeben über

Befehl "Umbenennen" (Team Foundation-Versionskontrolle)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022-

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

Anmerkung

Die Ergebnisse dieses Befehls werden erst auf dem Server widergespiegelt, wenn Sie ein Einchecken durchführen. Weitere Informationen finden Sie unter Entwickeln von Code und Verwalten ausstehender Änderungen.

Voraussetzungen

Wenn Sie den Befehl rename verwenden möchten, müssen Sie die berechtigung auf Zulassenfestgelegt haben. Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.

Syntax

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

Parameter

Argumente

Argument

Beschreibung

<olditem>

Der ursprüngliche Name und Pfad der datei oder des Ordners, die umbenannt werden sollen. Sie können einen lokalen Arbeitsbereichspfad wie C:\myfiles\314.cs oder einen TFVC-Serverpfad wie $/myfiles/314.csangeben.

<newitem>

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

<username>

Stellt einen Wert für die Option /login bereit. Sie können einen Benutzernamenswert entweder als DOMAIN\username oder als usernameangeben.

Optionen

Option

Beschreibung

/lock

Fügen Sie diese Option hinzu, um zu verhindern, dass andere Benutzer die angegebenen Elemente einchecken oder auschecken. Wenn diese Option nicht angegeben ist, 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 keine Überarbeitungen für gesperrte Dateien einchecken, bis Sie die Sperre durch Einchecken freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.
  • Checkout: Verhindert, dass andere Benutzer eines der angegebenen Elemente einchecken oder auschecken, bis Sie die Sperre durch ein Einchecken freigeben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

/login

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

Bemerkungen

Sie können den befehl rename des Befehlszeilenprogramms tf verwenden, um ein versionsgesteuertes Element in Ihrem Arbeitsbereich zu verschieben oder umzubenennen. Verwenden Sie den Befehl rename, um mehrere Dateien durch Angabe von Wildcardzeichen zu verschieben. Die Möglichkeit, mehrere versionsgesteuerte Dateien oder Ordner umzubenennen, ist nur über die Befehlszeile verfügbar.

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

  • Benennen Sie die olditem in den newitemum, z. B. tf rename 314.cs 315.cs.
  • Verschieben Sie die olditem an einen neuen Speicherort auf dem TFVC-Server, indem Sie eine newitem bereitstellen, deren Pfad sich vom olditemunterscheidet, z. B. tf rename 314.cs ..\newdir\314.cs.

Wenn Sie eine newitem angeben, die einen nicht vorhandenen Ordner angibt, erstellt der Befehl rename den Zielordner. Wenn newitem ein Ordner ist, wird olditem zu einem untergeordneten Element von newitem.

Sie können ein Element nicht umbenennen, wenn:

  • Sie haben sie bereits gelöscht, bevor sie in denselben Arbeitsbereich eingecheckt wurde.
  • Der neue Name ist bereits auf dem TFVC-Server vorhanden und ist kein Ordner.
  • Sie haben das ausstehende Einchecken des Elements bereits hinzugefügt, verzweigt oder umbenannt.
  • Das Element wird im Arbeitsbereich zugeordnet, aber nicht auf dem lokalen Datenträger verfügbar.
  • Das Element ist vermantelt.

Sie können ein Element umbenennen, für das eine andere Datei mit demselben Namen ausstehendes Einchecken hinzugefügt wurde. Sie können jedoch kein Element umbenennen, das verzweigt, aber noch nicht eingecheckt wurde. Wenn Sie eine Datei umbenennen, die ausstehende Bearbeitungen enthält, bleiben die Bearbeitungen erhalten.

Ein explizit zugeordnetes Element kann nicht umbenannt werden, ohne zuerst die Zuordnung zu ändern. Wenn beispielsweise eine Zuordnung des Arbeitsordners $/ProjectX/MyApp zum c:\MyAppvorhanden ist, können Sie MyApp-nicht umbenennen. Sie können Elemente unter MyAppumbenennen, aber nicht MyApp selbst.

Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.

Beispiele

Im folgenden Beispiel wird der Name von 314.cs in 1254.csgeä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 darauf angewendet.

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