Share via


Branch-opdracht (Team Foundation Version Control)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

De TFVC-opdracht branch kopieert een item of set items, inclusief de geschiedenis van metagegevens en versiebeheer, van de ene locatie naar de andere op de Azure DevOps-server en in de lokale werkruimte.

Notitie

De resultaten van deze opdracht worden pas weergegeven in de Azure DevOps-server als u een incheckbewerking uitvoert. Zie Check in your work to the team's codebase(s) voor meer informatie.

Vereisten

Als u de branch opdracht wilt gebruiken, moet u de machtiging Lezen voor het bronitem hebben en de machtigingen Uitchecken en Samenvoegen voor de doelmap instellen op Toestaan. Zie Standaard TFVC-machtigingen voor meer informatie.

Syntaxis

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

Parameters

Argument

Argument Beschrijving
<olditem> Hiermee geeft u de naam op van het bronbestand of de bronmap die wordt vertakt. De <olditem> indeling kan ook versie-informatie item;versionbevatten.
<newitem> Hiermee geeft u de naam van het doelbestand of de doelmap of de bovenliggende map voor de bestemming. Als <*newitem> deze al bestaat en een Azure DevOps Server-map is, maakt TFVC de vertakte items erin. <newitem> Anders geeft u de naam op van het doelbestand of de doelmap. Er kunnen conflicten optreden tijdens het inchecken als de bestemming al bestaat.
<versionspec> Biedt een waarde voor de /version optie. Zie Team Foundation-versiebeheeropdrachten gebruiken voor meer informatie over hoe TFVC een versiespecificatie parseert om te bepalen welke items binnen het bereik vallen.
<comment> Geeft een opmerking over de vertakking.
@<commentfile> Hiermee geeft u het pad op van een bestand dat de opmerking bevat die wordt gebruikt voor de vertakking.
<authorname> De door de gebruiker opgegeven waarde voor de /author optie.
<username> Biedt een waarde voor de /login optie. U kunt een gebruikersnaamwaarde opgeven als of DOMAIN\username <username>.

Optie

Optie

Beschrijving

/version

De versie van het item waarop u de vertakking wilt maken. U kunt een versie opgeven door:

  • Datum/tijd (D10/20/2005)
  • Wijzigingensetnummer (C1256)
  • Label (Lmylabel)
  • Nieuwste versie (T)
  • Werkruimte (Wworkspacename)

Als er geen versie is opgegeven, gebruikt TFVC de volgende logica om te bepalen welke versie van het item naar de nieuwe vertakking moet worden gekopieerd:

  • Als een Azure DevOps Server-pad is opgegeven, vertakt TFVC het item in de nieuwste Versie van Azure DevOps Server. Gebruikt bijvoorbeeld tf branch $/projects/help.cs de serverversie.
  • Als er een lokaal pad is opgegeven voor de bron, gebruikt TFVC de lokale werkruimteversie om de nieuwe vertakking te maken. Gebruikt bijvoorbeeld tf branch C:\314.cs de lokale werkruimteversie.

Als u een bestand vertakt waarvan de werkruimteversie ouder is dan de nieuwste versie op de Azure DevOps-server, wordt het bestand vertakt op de oudere versie.

/lock

Hiermee voorkomt u dat andere gebruikers items inchecken of uitchecken totdat u de vertakking in behandeling en de bijbehorende wijzigingen incheckt. Zie Understanding Lock Types (Vergrendelingstypen) voor meer informatie.

Vergrendelingsopties:

  • none
    Standaard. Er wordt geen vergrendeling toegepast. Als er een vergrendeling bestaat voor het bestand waarvoor u een vertakking maakt, wordt deze optie verwijderd.
  • checkin
    Andere gebruikers kunnen de opgegeven items uitchecken, maar ze kunnen geen revisies inchecken voor vergrendelde bestanden totdat u de vergrendeling loslaat door een check-in uit te voeren. Als andere gebruikers een van de opgegeven items hebben vergrendeld, mislukt de vergrendelingsbewerking.
  • checkout
    Hiermee voorkomt u dat andere gebruikers een van de opgegeven items inchecken of uitchecken totdat u de vergrendeling loslaat door een check-in uit te voeren. Als andere gebruikers een van de opgegeven items hebben vergrendeld, mislukt de vergrendelingsbewerking.

/noget

Als deze optie is opgegeven, worden lokale kopieën van de bestanden en mappen in de nieuwe vertakking niet gemaakt in de lokale werkruimte. Lokale kopieën worden echter opgehaald in de werkruimte wanneer u de volgende keer een recursieve get-bewerking uitvoert.

Notitie

U kunt voorkomen dat items, zoals de inhoud van een map /images , worden opgehaald naar uw werkruimte tijdens recursieve get en get latest bewerkingen door een werkruimtemap te klonen. Zie De opdracht Werkmap voor meer informatie.

/noprompt

Onderdrukt eventuele aanwijzingen voor invoer van u.

/silent

Geeft /nogetaan dat uitvoer niet naar het opdrachtpromptvenster wordt geschreven wanneer u een vertakking maakt.

/checkin

Maakt en controleert in de vertakking met de server in één bewerking. Met deze optie worden geen wijzigingen in behandeling in de lokale werkruimte gemaakt.

/comment

Voegt een opmerking toe aan de nieuwe vertakking. Deze optie wordt alleen gebruikt met de /checkin optie.

/author

Identificeert de auteur van de nieuwe vertakking. Deze optie wordt alleen gebruikt met de /checkin optie.

/recursive

Voor mappen vertakt u alle bestanden ook binnen.

Opmerkingen

Als u een lokaal pad opgeeft, zoals c:\00101 , maar geen opgeven <versionspec>, gebruikt TFVC de lokale werkruimteversie als basis voor het maken van de nieuwe vertakking.

Als u echter een serverpad opgeeft, zoals $/00101/*.cs en geen serverpad opgeeft <versionspec>, gebruikt TFVC de nieuwste Versie van Azure DevOps Server als basis voor het maken van de nieuwe vertakking.

Zie Team Foundation-versiebeheeropdrachten gebruiken voor meer informatie over het gebruik van het tf opdrachtregelprogramma.

Voorbeelden

In de volgende voorbeelden wordt ervan uitgegaan dat deze c:\projects wordt toegewezen aan de hoofdmap in de werkruimte.

In het volgende voorbeeld wordt een vertakkingsbestand gemaakt met de meest recente werkruimteversie van 314.cs, wordt het bestand 314_branch genoemd en opgeslagen in de huidige map op schijf en ook in de map Azure DevOps Server waaraan het wordt toegewezen.

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

In het volgende voorbeeld worden alle bestanden gekopieerd zonder bewerkingen in de werkruimteversie van 314.cs uit de huidige Azure DevOps Server-map naar de map testdata Azure DevOps Server en vanuit de huidige map op schijf naar de werkmap die is toegewezen aan de map Testdata Azure DevOps Server.

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

In het volgende voorbeeld worden alle bestanden gekopieerd zonder bewerkingen in de huidige werkruimteversie van de map testbestanden en de bestanden die deze bevat voor alle items uit de huidige map Azure DevOps Server naar de map testfiles_branch Azure DevOps Server en van c:\testfiles naar de lokale map die is toegewezen aan de map testfiles_branch Azure DevOps Server.

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

In het volgende voorbeeld wordt een vertakking van 314.cs gemaakt, omdat deze bestaat in de wijzigingenset #4 voor het bestand. In de werkmap op schijf, zoals op de Azure DevOps-server, wordt een vertakkingsbestand met de titel csharp_branch gemaakt.

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

In het volgende voorbeeld wordt een nieuwe vertakking van 314.cs gemaakt zoals op 12-12-03. In de werkmap op schijf zoals in de Azure DevOps-server wordt een vertakkingsbestand met de naam 314\branch gemaakt.

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

Het volgende voorbeeld vertakt de versie van 314.cs waarop het Beta1 label is toegepast, noemt het beta1branch en slaat deze op in de huidige map op schijf, naast de Azure DevOps Server-map waaraan de huidige map wordt toegewezen.

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