Delen via

Branch-opdracht (Team Foundation Version Control)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Met de opdracht TFVC branch kopieert u 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 codebasevoor meer informatie.

Voorwaarden

Als u de opdracht branch wilt gebruiken, moet u de machtiging Lezen voor het bronitem hebben en de en samenvoegen machtigingen voor de doelmap instellen op Toestaan. Zie standaard TFVC-machtigingenvoor 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> kan ook versie-informatie bevatten in de indeling item;version.
<newitem> Hiermee geeft u de naam van het doelbestand of de doelmap of de bovenliggende map voor de bestemming. Als <*newitem> al bestaat en een Azure DevOps Server-map is, maakt TFVC de vertakte items erin. Anders geeft <newitem> de naam van het doelbestand of de doelmap op. Er kunnen conflicten optreden tijdens het inchecken als de bestemming al bestaat.
<versionspec> Biedt een waarde voor de optie /version. Zie Team Foundation-versiebeheeropdrachten gebruikenvoor 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 optie /author.
<username> Biedt een waarde voor de optie /login. U kunt een gebruikersnaamwaarde opgeven als DOMAIN\username of <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. tf branch $/projects/help.cs gebruikt bijvoorbeeld de serverversie.
  • Als er een lokaal pad is opgegeven voor de bron, gebruikt TFVC de lokale werkruimteversie om de nieuwe vertakking te maken. tf branch C:\314.cs gebruikt bijvoorbeeld 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 Typesvoor meer informatie.

Vergrendelingsopties:

  • none
    Verstek. 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 /images map, worden opgehaald naar uw werkruimte tijdens recursieve get en get latest bewerkingen door een werkruimtemap te klonen. Zie Werkmapopdrachtvoor meer informatie.

/noprompt

Onderdrukt eventuele aanwijzingen voor invoer van u.

/silent

Impliceert /nogeten geeft aan 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 optie /checkin.

/author

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

/recursive

Voor mappen vertakt u alle bestanden ook binnen.

Opmerkingen

Als u een lokaal pad opgeeft, zoals c:\00101, maar geen <versionspec>opgeeft, 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 <versionspec>opgeeft, gebruikt TFVC de nieuwste Versie van Azure DevOps Server als basis voor het maken van de nieuwe vertakking.

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

Voorbeelden

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

In het volgende voorbeeld wordt een vertakkingsbestand gemaakt dat de meest recente werkruimteversie van 314.csbevat, de naam 314_branchen het bestand opslaat 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 zonder bewerkingen in de werkruimteversie van 314.cs gekopieerd van de huidige Map Azure DevOps Server naar de map testdata Azure DevOps Server en vanuit de huidige map op schijf naar de werkmap die wordt 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 testbestanden map en de bestanden die deze bevat voor alle items uit de huidige Map Azure DevOps Server in de map testfiles_branch Azure DevOps Server en van c:\testfiles in 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 in 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 op de Azure DevOps-server wordt een vertakkingsbestand met de naam 314\branch gemaakt.

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

In het volgende voorbeeld wordt de versie van 314.cs waarop het label Beta1 is toegepast, de naam Beta1branch, vertakt en wordt deze opgeslagen in de huidige map op schijf, naast de map Azure DevOps Server waaraan de huidige map wordt toegewezen.

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