Sdílet prostřednictvím

Příkaz Přejmenovat (Správa verzí Team Foundation)

  • Článek

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

Visual Studio 2019 | Visual Studio 2022

Příkaz TFVC (Team Foundation Version Control) rename změní název nebo cestu k souboru nebo složce. K přesunutí souboru nebo složky do nového umístění můžete použít příkaz rename nebo aliasy move nebo ren.

Poznámka

Výsledky tohoto příkazu se na serveru neprojeví, dokud se nevrátíte se změnami. Další informace najdete v tématu Vývoj kódu a správa čekajících změn.

Požadavky

Pokud chcete použít příkaz rename, nastavte oprávnění Rezervovat na Povolit. Další informace najdete v tématu Výchozí oprávnění TFVC.

Syntax

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

Parametry

Argumenty

argumentu

popis

<olditem>

Původní název a cesta k souboru nebo složce, které se mají přejmenovat. Můžete zadat místní cestu pracovního prostoru, například C:\myfiles\314.cs nebo cestu k serveru TFVC, například $/myfiles/314.cs.

<newitem>

Nový název souboru nebo složky. Můžete ho použít k určení jiného místního umístění nebo umístění cesty k serveru TFVC.

<username>

Poskytuje hodnotu /login možnosti. Hodnotu uživatelského jména můžete zadat buď jako DOMAIN\username, nebo username.

Volby

možnost

popis

/lock

Tuto možnost zahrňte, pokud chcete ostatním uživatelům zabránit v vrácení sem nebo rezervaci zadaných položek. Pokud tato možnost není zadaná, stávající stav zámku položky se nezmění. Další informace najdete v tématu Principy typů zámků.

Možnosti uzamčení:

  • None: Není použit žádný zámek.
  • Checkin: Ostatní uživatelé můžou rezervovat zadané položky, ale nemůžou vrátit revize uzamčených souborů, dokud zámek neuvolníte vrácením se změnami. Pokud někdo jiný uživatel zamkl některou ze zadaných položek, operace uzamčení selže.
  • Checkout: Zabrání ostatním uživatelům v vrácení se změnami nebo rezervaci některé ze zadaných položek, dokud zámek neuvolníte vrácením se změnami. Pokud někdo jiný uživatel zamkl některou ze zadaných položek, operace uzamčení selže.

/login

Určuje uživatelské jméno a heslo pro ověření uživatele pomocí Azure DevOps.

Poznámky

K přesunutí nebo přejmenování položky řízené verzí v pracovním prostoru můžete použít příkaz rename nástroje příkazového řádku tf. Pomocí příkazu rename můžete přesunout více souborů zadáním zástupných znaků. Možnost přejmenovat více souborů nebo složek řízených verzí je dostupná jenom z příkazového řádku.

Pomocí příkazu rename proveďte následující akce:

  • Přejmenujte olditem na newitem, například tf rename 314.cs 315.cs.
  • Přesuňte olditem na nové umístění na serveru TFVC tím, že poskytnete newitem, jehož cesta se liší od olditem, například tf rename 314.cs ..\newdir\314.cs.

Pokud zadáte newitem, která určuje neexistující složku, příkaz rename vytvoří cílovou složku. Pokud je newitem složkou, olditem se stane podřízeným newitem.

Položku nejde přejmenovat, pokud:

  • Už jste ho odstranili před vrácením se změnami do stejného pracovního prostoru.
  • Nový název již existuje na serveru TFVC a není složka.
  • Už jste přidali, rozvětveni nebo přejmenovali čekající vrácení položky se změnami.
  • Položka se mapuje v pracovním prostoru, ale není k dispozici na místním disku.
  • Položka je zakrytá.

Položku, pro kterou byl přidán jiný soubor se stejným názvem, můžete přejmenovat čekající vrácení se změnami, ale nemůžete přejmenovat položku, která byla větvena, ale ještě není vrácena se změnami. Při přejmenování souboru, který obsahuje čekající úpravy, se úpravy zachovají.

Položku, která je explicitně namapovaná, nelze přejmenovat bez první změny mapování. Pokud je například mapování pracovních složek $/ProjectX/MyApp na c:\MyApp, nemůžete přejmenovat MyApp . Položky v moje aplikace můžete přejmenovat, ale ne myApp.

Další informace o použití nástroje příkazového řádku tf naleznete v tématu Použití příkazů správy verzí Team Foundation.

Příklady

Následující příklad změní název 314.cs na 1254.cs.

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

Následující příklad přejmenuje 314.cs na 1254.cs a přesune ji do složky newdir.

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

Následující příklad změní název Form1.vb na MainPage.vb a použije na něj zámek.

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