Příkaz Popisek (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) tf label připojí popisek k verzi souboru nebo složky na serveru TFVC nebo ho odebere.

Požadavky

Pokud chcete tento příkaz použít label , musíte mít oprávnění Popisek nastavené na Povolit. Pokud chcete upravit nebo odstranit popisky vytvořené jinými uživateli, musíte mít oprávnění Správa ister labels nastaveno na Povolit. Další informace naleznete v tématu Výchozí oprávnění TFVC.

Syntaxe

tf label labelname[@scope] [/owner:ownername] 
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)] 
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]	

tf label /delete labelname[@scope] 
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parametry

Argumenty

Argument

Popis

<labelname>

Určuje název popisku, který se má připojit, upravit nebo odebrat ze zadaných položek.

@<scope>

Určuje adresář serveru TFVC, ve kterém labelname je jedinečný. Tento parametr umožňuje nezávisle vytvářet, spravovat, načítat a odstraňovat jeden popisek nebo sadu označených položek, pokud jsou dva popisky stejného názvu v různých částech serveru TFVC.

<ownername>

Poskytuje hodnotu, například DOMAIN\JuanGo nebo jen juango pro /owner tuto možnost.

<itemspec>

Identifikuje soubor nebo složku, ze které se má popisek označit, znovu označit nebo upravit. Další informace o tom, jak TFVC analyzuje itemspec položky v rámci oboru, naleznete v tématu Použití příkazů správy verzí Team Foundation.

Poznámka:

Můžete zadat více než jeden itemspec argument.

<versionspec>

Poskytuje hodnotu, například c2 pro /version tuto možnost. Další informace o tom, jak TFVC parsuje specifikaci verze k určení položek v rámci oboru, naleznete v tématu Použití příkazů správy verzí Team Foundation.

<comment>

Komentář k popisku zadaný uživatelem.

@<commentfile>

Uživatelsky poskytnutá cesta k souboru na disku, který obsahuje komentář, který se má použít pro popisek.

<username>

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

<TeamProjectCollectionUrl>

Adresa URL zadané kolekce projektů, která obsahuje verzi souboru nebo složky, ke které chcete připojit popisek nebo ze kterého chcete odstranit popisek, například http://myserver:8080/tfs/DefaultCollection.

Možnosti

Možnost

Popis

/owner

Určuje jméno uživatele, který vlastní popisek.

/version

Nepovinné. Určuje verzi souboru nebo složky, ke které má být popisek připojen, změněn nebo ze kterého má být popisek odebrán. Jedná se například C93o hodnoty sady změn. TfVC ve výchozím nastavení používá základní verzi pracovního prostoru, pokud versionspec není k dispozici.

/comment

Přidá nebo upraví popisek nebo komentář.

/child

Není zdokumentováno.

/recursive

Označí všechny položky v adresáři, které odpovídají vašemu itemspec a versionspec. S možností se nedá použít /delete .

/delete

Odebere popisek.

/login

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

/collection

Určuje kolekci projektů.

Poznámky

Popisek je značka, kterou můžete připojit k sadě jinak nesouvisejících souborů a složek na serveru TFVC. Popisek slouží ke zjednodušení načítání souborů a složek do pracovního prostoru pro účely vývoje nebo sestavení. Popisek je jako sada změn nebo datum a čas, ze kterého můžete libovolně přidávat a odebírat soubory a složky nebo měnit jejich verze. Popisek je specifikace verze, kterou lze předat následujícím příkazům TFVC:

Mezi běžné typy popisků patří popisky milníků, jako M1je , Beta2nebo Release Candidate 0.

Popisky jsou specifické pro konkrétní verzi. To znamená, že popisek můžete připojit pouze k jedné verzi souboru nebo složky. Každá verze položky může podporovat více popisků.

Popisek není objekt s verzí. Proto se historie popisků souborů nesleduje. Operace popisku také nevytvoří čekající změnu v pracovním prostoru. Když příkaz vydáte label , aktualizace se okamžitě projeví na serveru TFVC.

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.

Odebrání a odstranění popisků

Pomocí příkazu Unlabel můžete odebrat popisek ze souboru nebo složky. Případně můžete pomocí příkazu odstranit popisek ze systému tf label /delete .

Informace o existujícím popisku, který obsahuje seznam položek, ke kterým byl popisek připojen, komentář, obor a vlastník, najdete v části Příkaz Popisky.

Správa přetížených popisků

Názvy popisků musí být v zadaném oboru jedinečné. Když přidáte popisek, vyhrazujete si použití tohoto názvu popisku v zadaném nebo předpokládaném rozsahu. Výchozí hodnota parametru @scope je projekt, například $/TeamProject1.

Pokud jiný tým nebo uživatel přidá běžný popisek, například M3 do sady souborů řízených verzí v jiné části serveru TFVC, můžete popisek použít M3 u souborů řízených verzí v projektu, pokud jsou kořenové složky projektu v různých adresářích. Pokud jsou například soubory v adresáři $/math označené M3, můžete ho M3 také použít u souborů v adresáři $/projects .

Pokud chcete získat, odebrat popisek nebo jinak spravovat položky M3s popiskem -labeled, měli byste zadat @scope parametr, kterým tfVC řeknete, se kterým M3 popiskem chcete pracovat.

Jiným uživatelům můžete zabránit v přetížení popisku, například M3 v různých částech serveru TFVC, vytvořením popisku v kořenovém adresáři $/ serveru Pro správu verzí Team Foundation nebo úpravou oprávnění popisku pro určité složky.

Příklady

Následující příklad připojí goodbuild popisek k verzi pracovního prostoru složky docs a souborů a složek, které obsahuje.

c:\projects>tf label goodbuild docs /recursive

Následující příklad připojí goodbuild popisek ke složce docs , ale ne k souborům a složkám , které složka docs obsahuje.

c:\projects>tf label goodbuild docs

Následující příklad připojí goodbuild popisek k verzi 3 314.cs na serveru TFVC.

c:\projects>tf label goodbuild /version:3 $/src/314.cs

Následující příklad odstraní badbuild popisek ze všech položek na serveru TFVC.

c:\projects>tf label /delete badbuild

Následující příklad používá @ možnost oboru použít popisek na 314.cs.

c:\projects>tf label goodbuild@$/TeamProject1 314.cs