Grenkommando (Versionskontroll för Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

TFVC-kommandot branch kopierar ett objekt eller en uppsättning objekt, inklusive metadata och versionskontrollhistorik, från en plats till en annan på Azure DevOps-servern och på den lokala arbetsytan.

Kommentar

Resultatet av det här kommandot återspeglas inte på Azure DevOps-servern förrän du utför en incheckningsåtgärd. Mer information finns i Checka in ditt arbete till teamets kodbas.

Förutsättningar

Om du vill använda branch kommandot måste du ha läsbehörigheten för källobjektet och behörigheterna Checka ut och koppla för målmappen har angetts till Tillåt. Mer information finns i TFVC-standardbehörigheter.

Syntax

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

Parametrar

Argument

Argument Beskrivning
<olditem> Anger namnet på källfilen eller mappen som förgrenas. <olditem> Kan också innehålla versionsinformation i formatet item;version.
<newitem> Anger namnet på målfilen eller mappen eller den överordnade mappen för målet. Om <*newitem> det redan finns och är en Azure DevOps Server-mapp skapar TFVC de förgrenade objekten i den. I annat fall <newitem> anger du namnet på målfilen eller mappen. Konflikter kan uppstå under incheckningen om målet redan finns.
<versionspec> Ger ett värde för /version alternativet. Mer information om hur TFVC parsar en versionsspecifikation för att avgöra vilka objekt som ligger inom dess omfång finns i Använda Team Foundation-versionskontrollkommandon.
<comment> Ger en kommentar om grenen.
@<commentfile> Anger sökvägen till en fil som innehåller kommentaren som används för grenen.
<authorname> Det användardefinierade värdet för /author alternativet.
<username> Ger alternativet ett värde /login . Du kan ange ett användarnamnsvärde som antingen DOMAIN\username eller <username>.

Alternativ

Alternativ

Beskrivning

/version

Den version av objektet där du vill skapa grenen. Du kan ange en version genom att:

  • Datum/tid (D10/20/2005)
  • Ändringsuppsättningsnummer (C1256)
  • Etikett (Lmylabel)
  • Senaste versionen (T)
  • Arbetsyta (Wworkspacename)

Om ingen version anges använder TFVC följande logik för att bestämma vilken version av objektet som ska kopieras till den nya grenen:

  • Om en Azure DevOps Server-sökväg har angetts förgrenar TFVC objektet med den senaste Versionen av Azure DevOps Server. Använder till exempel tf branch $/projects/help.cs serverversionen.
  • Om en lokal sökväg anges för källan använder TFVC den lokala arbetsyteversionen för att skapa den nya grenen. Använder till exempel tf branch C:\314.cs den lokala arbetsyteversionen.

Om du förgrenar en fil vars arbetsyteversion är äldre än den senaste versionen på Azure DevOps-servern förgrenas filen i den äldre versionen.

/lock

Hindrar andra användare från att checka in eller checka ut objekt tills du checkar in din väntande gren och tillhörande ändringar. Mer information finns i Förstå låstyper.

Låsalternativ:

  • none
    Standard. Inget lås tillämpas. Om det finns ett lås på filen som du skapar en gren för, tar det här alternativet bort den.
  • checkin
    Andra användare kan checka ut de angivna objekten, men de kan inte checka in revisioner av låsta filer förrän du släpper låset genom att utföra en incheckning. Om några andra användare har låst något av de angivna objekten misslyckas låsåtgärden.
  • checkout
    Hindrar andra användare från att checka in eller checka ut något av de angivna objekten tills du släpper låset genom att utföra en incheckning. Om några andra användare har låst något av de angivna objekten misslyckas låsåtgärden.

/noget

Om det här alternativet anges skapas inte lokala kopior av filerna och mapparna i den nya grenen på den lokala arbetsytan. Lokala kopior hämtas dock till arbetsytan nästa gång du utför en rekursiv get-åtgärd.

Kommentar

Du kan förhindra att objekt, till exempel innehållet i en /images-mapp , hämtas till din arbetsyta under rekursiv hämtning och hämtar de senaste åtgärderna genom att dölja en arbetsytemapp. Mer information finns i Arbetsmappskommando.

/noprompt

Undertrycker alla uppmaningar om indata från dig.

/silent

Antyder /nogetoch anger att utdata inte skrivs till kommandotolken när du skapar en gren.

/checkin

Skapar och kontrollerar i -grenen till servern i en åtgärd. Det här alternativet skapar inga väntande ändringar på den lokala arbetsytan.

/comment

Lägger till en kommentar till den nya grenen. Det här alternativet används endast med alternativet /checkin .

/author

Identifierar författaren till den nya grenen. Det här alternativet används endast med alternativet /checkin .

/recursive

För mappar förgrenar du även alla filer inuti.

Kommentarer

Om du anger en lokal sökväg, till exempel c:\00101 men inte anger en <versionspec>, använder TFVC den lokala arbetsyteversionen som grund för att skapa den nya grenen.

Men om du anger en serversökväg, till exempel $/00101/*.cs och inte anger en <versionspec>, använder TFVC den senaste Versionen av Azure DevOps Server som grund för att skapa den nya grenen i stället.

Mer information om hur du använder tf kommandoradsverktyget finns i Använda Team Foundation-versionskontrollkommandon.

Exempel

I följande exempel förutsätts att c:\projects mappar till huvudmappen på arbetsytan.

I följande exempel skapas en grenfil som innehåller den senaste arbetsyteversionen av 314.cs, namnger den 314_branch och sparar den i den aktuella katalogen på disken och även till mappen Azure DevOps Server som den mappar till.

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

I följande exempel kopieras alla filer utan väntande ändringar i arbetsyteversionen av 314.cs från den aktuella Azure DevOps Server-mappen till mappen testdata Azure DevOps Server och från den aktuella katalogen på disken till arbetsmappen som mappar till mappen testdata Azure DevOps Server.

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

I följande exempel kopieras alla filer utan väntande ändringar i den aktuella arbetsyteversionen av mappen testfiles och filerna som den innehåller för alla objekt från den aktuella Azure DevOps Server-mappen till mappen testfiles_branch Azure DevOps Server och från c:\testfiles till den lokala mappen som mappar till mappen testfiles_branch Azure DevOps Server.

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

I följande exempel skapas en gren av 314.cs eftersom den fanns i ändringsuppsättning nr 4 för filen. I arbetsmappen på disken, som på Azure DevOps-servern, skapas en grenfil med namnet csharp_branch .

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

I följande exempel skapas en ny gren av 314.cs som den var den 12/12/03. I arbetsmappen på disken som på Azure DevOps-servern skapas en grenfil med namnet 314\branch .

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

I följande exempel förgrenas versionen av 314.cs som Beta1 etiketten tillämpades på, namnger den Beta1branch och sparar den i den aktuella katalogen på disken utöver mappen Azure DevOps Server som den aktuella katalogen mappar till.

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