Sdílet prostřednictvím

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

Požadavky

Pokud chcete použít příkaz , nastavte oprávnění popisku na Povolit. Chcete-li upravit nebo odstranit popisky vytvořené jinými uživateli, mají Spravovat popisky oprávnění nastavena na Povolit. Další informace najdete v tématu Výchozí oprávnění TFVC.

Syntax

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

argumentu

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 je labelname 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, jako je DOMAIN\JuanGo nebo jen juango, do možnosti /owner.

<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 určit, které položky jsou v oboru, najdete 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 možnost /version. Další informace o tom, jak TFVC parsuje specifikaci verze k určení položek v jeho oboru, najdete 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 /login možnosti. Hodnotu uživatelského jména můžete zadat buď jako DOMAIN\username, nebo 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.

Volby

možnost

popis

/owner

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

/version

Volitelný. 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 o hodnoty sady změn, například C93. TfVC ve výchozím nastavení používá základní verzi pracovního prostoru, pokud není k dispozici žádná versionspec.

/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. Nelze použít s možností /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:

  • příkazu Branch
  • příkazu Difference
  • příkazu Dir
  • příkazu Get
  • příkazu Historie
  • příkazu sloučit
  • příkaz Zobrazit

Běžnými typy popisků jsou popisky milníků, jako jsou M1, 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ž vydáte příkaz label, aktualizace se okamžitě projeví na serveru TFVC.

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.

Odebrání a odstranění popisků

Popisek ze souboru nebo složky můžete odebrat pomocí příkazu Unlabel. Případně můžete popisek ze systému odstranit pomocí příkazu 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 tématu 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 M3 použít 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čeny M3, můžete M3 popisek použít také u souborů v adresáři $/projects.

Pokud chcete získat, odebrat popisek nebo jinak spravovat položky M3-labeled, měli byste zadat @scope parametr, který určuje TFVC, se kterým M3 popiskem, se kterým 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, a to buď vytvořením popisku v kořenovém $/ serveru správy verzí Team Foundation, nebo úpravou oprávnění Popisek pro určité složky.

Příklady

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

c:\projects>tf label goodbuild docs /recursive

Následující příklad připojí 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í popisek goodbuild k verzi 3 314.cs na serveru TFVC.

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

Následující příklad odstraní popisek badbuild 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