Share via

Branch command (Team Foundation Version Control)

  • Cikk

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

Visual Studio 2019 | Visual Studio 2022

A TFVC branch parancs az Azure DevOps-kiszolgálón és a helyi munkaterületen átmásol egy elemet vagy elemkészletet, beleértve a metaadatokat és a verziókövetési előzményeket is.

Feljegyzés

A parancs eredményei mindaddig nem jelennek meg az Azure DevOps-kiszolgálón, amíg nem hajt végre bejelentkezési műveletet. További információ: A csapat kódbázisának beadása a munkájában.

Előfeltételek

A branch parancs használatához olvasási engedéllyel kell rendelkeznie a forráselemhez, és engedélyeznie kell acélmappa kivételi és egyesítési engedélyeit. További információ: Alapértelmezett TFVC-engedélyek.

Syntax

tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]] [/recursive]

Paraméterek

Argumentum

Argumentum Leírás
<olditem> Megadja az elágaztatott forrásfájl vagy mappa nevét. A <olditem> formátum verzióinformációkat item;versionis tartalmazhat.
<newitem> Megadja a célfájl vagy mappa nevét, illetve a célhely szülőmappáját. Ha <*newitem> már létezik, és egy Azure DevOps Server-mappa, a TFVC létrehozza a benne lévő elágaztatott elemeket. <newitem> Ellenkező esetben a célfájl vagy mappa nevét adja meg. Ütközések léphetnek fel a bejelentkezés során, ha a cél már létezik.
<versionspec> A beállítás értékét /version adja meg. 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> Megjegyzést fűz az ághoz.
@<commentfile> Megadja az ághoz használt megjegyzést tartalmazó fájl elérési útját.
<authorname> A beállítás felhasználó által /author megadott értéke.
<username> Értéket ad a /login beállításnak. Megadhatja a felhasználónév értékét vagy DOMAIN\username<username>a .

Lehetőség

Beállítás

Leírás

/version

Annak az elemnek a verziója, amelyen létre szeretné hozni az ágat. A verziót a következővel adhatja meg:

  • Dátum/idő (D10/20/2005)
  • Változáskészlet száma (C1256)
  • Címke (Lmylabel)
  • Legújabb verzió (T)
  • Munkaterület (Wworkspacename)

Ha nincs megadva verzió, a TFVC a következő logikával dönti el, hogy az elem melyik verzióját másolja az új ágba:

  • Ha egy Azure DevOps Server-elérési út van megadva, akkor a TFVC az elemet a legújabb Azure DevOps Server-verzióban ágaztatja el. Például tf branch $/projects/help.cs a kiszolgáló verzióját használja.
  • Ha a forráshoz helyi elérési út van megadva, a TFVC a helyi munkaterület verzióját használja az új ág létrehozásához. Például tf branch C:\314.cs a helyi munkaterület verzióját használja.

Ha elágaztat egy olyan fájlt, amelynek munkaterületi verziója régebbi, mint az Azure DevOps-kiszolgáló legújabb verziója, a fájl a régebbi verzióra lesz elágazva.

/lock

Megakadályozza, hogy más felhasználók be- vagy kijelentkeztetik az elemeket, amíg be nem jelentkezik a függőben lévő ág és a kapcsolódó módosítások. További információ: A zárolási típusok ismertetése.

Zárolási beállítások:

  • none
    Default (Alapértelmezett): Nincs zárolás alkalmazva. Ha egy zárolt fájl található azon a fájlon, amelyhez ágat hoz létre, ez a beállítás eltávolítja azt.
  • checkin
    Más felhasználók megtekinthetik a megadott elemeket, de a zárolás feloldásáig nem ellenőrizhetik a korrektúrákat a zárolt fájlokban. Ha bármely más felhasználó zárolta a megadott elemek bármelyikét, a zárolási művelet meghiúsul.
  • checkout
    Megakadályozza, hogy más felhasználók a megadott elemek bármelyikét be- vagy kijelentkeztetik, amíg a zárolást nem oldja fel a bejelentkezés végrehajtásával. Ha bármely más felhasználó zárolta a megadott elemek bármelyikét, a zárolási művelet meghiúsul.

/noget

Ha ez a beállítás meg van adva, az új ág fájljainak és mappáinak helyi másolatai nem jönnek létre a helyi munkaterületen. A helyi másolatok azonban a következő rekurzív lekérési művelet végrehajtásakor lesznek beolvasva a munkaterületre.

Feljegyzés

Megakadályozhatja, hogy az elemek, például a /images mappa tartalma a rekurzív beolvasás során lekérhetők legyenek a munkaterületre, és egy munkaterület mappájának álcázásával lekérje a legújabb műveleteket. További információ: Workfold Command.

/noprompt

Letiltja az Öntől érkező bemeneti kéréseket.

/silent

Azt jelenti /noget, hogy a kimenet nem lesz megírva a parancssori ablakba egy ág létrehozásakor.

/checkin

Egyetlen művelettel hozza létre és ellenőrzi az ágat a kiszolgálón. Ez a beállítás nem hoz létre függőben lévő módosításokat a helyi munkaterületen.

/comment

Megjegyzést fűz az új ághoz. Ez a beállítás csak a /checkin beállítással használható.

/author

Az új ág szerzőjének azonosítása. Ez a beállítás csak a /checkin beállítással használható.

/recursive

Mappák esetén az összes fájlt is elágaztatjuk.

Megjegyzések

Ha olyan helyi elérési utat ad meg, mint a c:\00101 , de nem ad meg <versionspec>, a TFVC a helyi munkaterület verzióját használja az új ág létrehozásához.

Ha azonban olyan kiszolgálói útvonalat ad meg, mint például a $/00101/*.cs , és nem ad meg, <versionspec>akkor a TFVC a legújabb Azure DevOps Server-verziót használja az új ág létrehozásához.

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.

Példák

Az alábbi példák feltételezik, hogy c:\projects a munkaterület fő mappájába van leképzve.

Az alábbi példa létrehoz egy ágfájlt, amely tartalmazza a 314.cs legújabb munkaterületi verzióját, elnevezi 314_branch, és menti azt a lemez aktuális könyvtárába, valamint az Azure DevOps Server mappába, amelyhez leképezi.

c:\projects>tf branch 314.cs 314_branch

Az alábbi példa az 314.cs munkaterületi verziójában függőben lévő módosítások nélküli összes fájlt átmásolja az aktuális Azure DevOps Server-mappából a testdata Azure DevOps Server mappába, a lemez aktuális könyvtárából pedig a testdata Azure DevOps Server mappába leképező munkamappába.

c:\projects>tf branch C:\314.cs $/testdata

Az alábbi példa az összes fájlt átmásolja a tesztfájlok mappa aktuális munkaterületi verziójában végzett módosítások nélkül, valamint az aktuális Azure DevOps Server-mappában lévő összes elemhez tartozó fájlokat az testfiles_branch Azure DevOps Server mappába, a c:\testfile-okat pedig a testfiles_branch Azure DevOps Server mappába leképező helyi mappába.

c:\projects>tf branch C:\testfiles $/testfiles_branch

Az alábbi példa létrehozza a 314.cs egy ágát, mivel a fájl 4. módosítási halmazában létezett. A lemez munkamappájában, az Azure DevOps-kiszolgálóhoz hasonlóan egy csharp_branch nevű ágfájl jön létre.

c:\projects>tf branch C:\314.cs;C4 csharp_branch

Az alábbi példa a 03.12.12-i 314.cs új ágát hozza létre. A lemez munkamappájában, mint az Azure DevOps-kiszolgálón, létrejön egy 314\branch nevű ágfájl.

c:\projects>tf branch 314.cs;D12/12/03 314_branch

Az alábbi példa elágaztatja a 314.cs azon verzióját, amelyre a Beta1 címkét alkalmazták, beta1branch néven elnevezi, és menti azt a lemez aktuális könyvtárába az Azure DevOps Server mappán kívül, amelyre az aktuális könyvtár leképezi.

c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch