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 Správa verzí Team Foundation (TFVC) 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 rename příkaz, aliasy nebo renaliasy move nebo složky.

Poznámka:

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

Požadavky

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

Syntaxe

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

Parametry

Argumenty

Argument

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 možnosti /login . Hodnotu uživatelského jména můžete zadat buď nebo DOMAIN\username username.

Možnosti

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 Vysvětlení 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

Pomocí příkazu nástroje příkazového tf řádku můžete rename přesunout nebo přejmenovat položku řízenou verzí ve vašem pracovním prostoru. rename Pomocí příkazu 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.

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

  • olditem Přejmenujte na soubor newitem, například tf rename 314.cs 315.cs.
  • Přesuňte na olditem nové umístění na serveru TFVC zadáním newitem cesty, jejíž cesta se liší od olditemumístění , například tf rename 314.cs ..\newdir\314.cs.

Pokud zadáte newitem složku, která určuje neexistující složku, rename příkaz vytvoří cílovou složku. Pokud newitem je složka, olditem stane se podřízenou položkou 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 myApp přejmenovat. Položky v myAppu můžete přejmenovat, ale ne samotnou aplikaci MyApp.

Další informace o tom, jak používat nástroj příkazového tf řádku, 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