Share via

Label command (Team Foundation Version Control)

  • Cikk

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

Visual Studio 2019 | Visual Studio 2022

A Team Foundation Version Control (TFVC) tf label parancs egy címkét csatol a TFVC-kiszolgáló egyik fájljának vagy mappájának egy verziójához, vagy eltávolít egy címkét.

Előfeltételek

A label parancs használatához engedélyezve kell lennie a Címke engedélynek. A más felhasználók által létrehozott címkék módosításához vagy törléséhez engedélyeznie kell a Rendszergazda címkecímkék engedélyét. További információ: Alapértelmezett TFVC-engedélyek.

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]

Paraméterek

Argumentumok

Argumentum

Leírás

<labelname>

A megadott elemekhez csatolandó, módosítandó vagy eltávolítandó címke nevét azonosítja.

@<scope>

Egy TFVC-kiszolgáló könyvtárát adja meg, amelyen belül az labelname egyedi. Ez a paraméter lehetővé teszi, hogy függetlenül hozzon létre, kezelhessen, lekérhessen és töröljön egy címkével ellátott elemet vagy halmazt, ha két azonos nevű címke a TFVC-kiszolgáló különböző részeiben található.

<ownername>

A beállításhoz hasonló DOMAIN\JuanGojuango értéket ad /owner meg.

<itemspec>

Azonosítja azt a fájlt vagy mappát, amelyről címkézni, újracímkézni vagy módosítani szeretné. További információ arról, hogy a TFVC hogyan elemzi a itemspec hatókörön belüli elemeket, olvassa el a Team Foundation verziókövetési parancsainak használatát ismertető témakört.

Feljegyzés

Több itemspec argumentumot is megadhat.

<versionspec>

Olyan értéket ad meg, mint c2 a /version beállítás. További információ arról, hogy a TFVC hogyan elemzi a verzióspecifikációt annak meghatározásához, hogy mely elemek tartoznak a hatókörébe: A Team Foundation verziókövetési parancsainak használata.

<comment>

Felhasználó által megadott megjegyzés a címkével kapcsolatban.

@<commentfile>

A lemezen található fájl felhasználó által megadott elérési útja, amely tartalmazza a címkéhez használni kívánt megjegyzést.

<username>

Értéket ad a /login beállításnak. Megadhatja a felhasználónév értékét vagy DOMAIN\usernameusernamea .

<TeamProjectCollectionUrl>

A megadott projektgyűjtemény URL-címe, amely egy olyan fájl vagy mappa verzióját tartalmazza, amelyhez címkét szeretne csatolni, vagy amelyből például http://myserver:8080/tfs/DefaultCollectiontörölni szeretne egy címkét.

Beállítások

Beállítás

Leírás

/owner

Annak a felhasználónak a nevét adja meg, aki a címkét birtokolja.

/version

Opcionális. Megadja annak a fájlnak vagy mappának a verzióját, amelyhez a címkét csatolni, módosítani kell, vagy amelyből a címkét el kell távolítani. Ezek például a változáskészlet értékei. C93 Alapértelmezés szerint a TFVC az alap-munkaterület verzióját használja, ha nincs versionspec megadva.

/comment

A címke leírását vagy megjegyzését adja hozzá vagy módosítja.

/child

Nincs dokumentálva.

/recursive

A címtárban található összes olyan elem felirata, amely megfelel az Ön itemspec és versionspeca . A beállítás nem használható /delete .

/delete

Eltávolítja a címkét.

/login

Megadja a felhasználónevet és a jelszót, amellyel hitelesítheti a felhasználót az Azure DevOpsszal.

/collection

A projektgyűjteményt adja meg.

Megjegyzések

A címke egy jelölő, amelyet a TFVC-kiszolgálón lévő, egyébként nem kapcsolódó fájlokhoz és mappákhoz csatolhat. A címke használatával egyszerűsítheti a munkaterületre történő fájl- és mappalekérést fejlesztési vagy buildelési célokra. A címke olyan, mint egy módosításkészlet vagy dátum/idő, amelybe tetszőlegesen hozzáadhat és eltávolíthat fájlokat és mappákat, vagy módosíthatja az elemek verzióit. A címke egy verzióspecifikáció, amely a következő TFVC-parancsok számára adható át:

A címkék gyakori típusai a mérföldkőcímkék, például M1az , Beta2vagy Release Candidate 0a .

A címkék verzióspecifikusak. Vagyis csak egy fájl vagy mappa egy verziójához csatolhat címkét. Egy elem minden verziója több címkét is támogat.

A címke nem verziószámozott objektum. Ezért a fájlok címkeelőzményei nincsenek nyomon követve. Emellett a címkeművelet nem hoz létre függőben lévő módosítást a munkaterületen. A parancs kiadásakor label a frissítés azonnal megjelenik a TFVC-kiszolgálón.

A parancssori segédprogram használatáról további információt a tf Team Foundation verziókövetési parancsainak használata című témakörben talál.

Címkék eltávolítása és törlése

A Címke törlése paranccsal eltávolíthat egy címkét egy fájlból vagy mappából. Másik lehetőségként törölheti a címkét a rendszerből a tf label /delete parancs használatával.

Egy meglévő címkéről, amely tartalmazza a címkéhez csatolt elemek listáját, megjegyzését, hatókörét és tulajdonosát, olvassa el a Címkék parancsot.

Túlterhelt címkék kezelése

A címkeneveknek egyedinek kell lenniük egy megadott hatókörben. Címke hozzáadásakor fenntartja a címkenév használatát a megadott vagy hallgatólagos hatókörben vagy alatt. A paraméter alapértelmezett értéke a @scope projekt, például $/TeamProject1.

Ha egy másik csapat vagy felhasználó hozzáad egy közös címkét, például M3 a TFVC-kiszolgáló egy másik részén található verzióvezérelt fájlokhoz, a címkét alkalmazhatja M3 a projekt verzióvezérelt fájljaira, feltéve, hogy a fő projektmappák különböző könyvtárakban találhatók. Ha például a $/math könyvtárban lévő fájlok címkével vannak ellátvaM3, akkor a M3 címkét a $/projects könyvtár fájljaira is alkalmazhatja.

A címke lekéréséhez, eltávolításához vagy más módon a M3címkével ellátott elemek kezeléséhez meg kell adnia azt a paramétert, amellyel megadhatja a @scope TFVC-nek, hogy melyik M3 címkével szeretne dolgozni.

Megakadályozhatja, hogy más felhasználók "túlterhelnek" egy címkét, például M3 a TFVC-kiszolgáló különböző részein, ha a címkét a Team Foundation verzióvezérlő kiszolgálójának gyökerében $/ hozza létre, vagy módosítja bizonyos mappák címkeengedélyeit .

Példák

Az alábbi példa a goodbuild dokumentummappa munkaterületi verziójához és a benne található fájlokhoz és mappákhoz csatolja a címkét.

c:\projects>tf label goodbuild docs /recursive

Az alábbi példa a dokumentummappához csatolja a goodbuild címkét, de nem azokhoz a fájlokhoz és mappákhoz, amit a dokumentummappa tartalmaz.

c:\projects>tf label goodbuild docs

Az alábbi példa a goodbuild TFVC-kiszolgálón található 314.cs 3. verziójához csatolja a címkét.

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

Az alábbi példa törli a címkét a badbuild TFVC-kiszolgáló összes eleméből.

c:\projects>tf label /delete badbuild

Az alábbi példa a @ hatókör beállításával alkalmaz címkét 314.cs.

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