Dela via


Hämta kommando (Versionskontroll för Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

Kommandot Team Foundation Version Control (TFVC) get hämtar, eller laddar ned, antingen den senaste versionen eller en angiven version av en eller flera filer eller mappar från Azure DevOps Server till arbetsytan. Kommandot tf get tillhandahåller ett annat användargränssnitt än Visual Studio, men processen är i grunden densamma. Mer information om hur du använder Visual Studio för att hämta filer och mappar finns i Ladda ned (hämta) filer från servern.

Förutsättningar

Se TFVC-standardbehörigheter.

Syntax

tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]

Parametrar

Parameter

Beskrivning

/all

Du kan använda det här alternativet för att återställa ett objekt som du av misstag har tagit bort från en serverarbetsyta. Om du använder en lokal arbetsyta, vilket rekommenderas, är det osannolikt att du behöver använda det här alternativet.

TFVC har en intern post med alla objekt som arbetsytan innehåller, inklusive versionen av var och en. Om den interna posten på servern anger att arbetsytan redan har den version du får hämtar den som standard inte objektet när du hämtar filer. Det här alternativet hämtar alla objekt oavsett vilka data den interna posten innehåller.

/force

Kombinerar /all och /overwrite.

<itemspec>

Anger omfånget för de objekt som ska hämtas. Du kan ange mer än ett itemspec argument. Om inget itemspec anges hämtar systemet rekursivt alla objekt i den aktuella arbetsytan.

Syntax finns i Använda Team Foundation-versionskontrollkommandon.

/login <username>,[<password>]

Anger vilket användarkonto som ska köra kommandot. Mer information finns i Använda kommandon för versionskontroll i Team Foundation.

/noautoresolve

Som standard försöker systemet automatiskt lösa alla konflikter automatiskt. Mer information finns i Lösa konflikter med Team Foundation-versionskontroll. Ange det här alternativet för att inaktivera det här standardbeteendet.

/noprompt

Undertrycker visning av Visual Studio-fönster och dialogrutor och omdirigerar utdata till kommandotolken. Mer information finns i Använda kommandon för versionskontroll i Team Foundation.

/overwrite

Som standard hämtar systemet inte ett objekt om det är skrivbart, det vill sig vara dess skrivskyddade attribut rensas på klientdatorn. Det här alternativet åsidosätter standardbeteendet och skriver över ett skrivbart objekt, såvida inte objektet är utcheckat. Om du använder en lokal arbetsyta enligt rekommendationerna är det osannolikt att du behöver använda det här alternativet.

/preview

Visar vad som skulle inträffa, utan att utföra åtgärden get .

/recursive

Rekursivt hämtar objekt i den angivna katalogen och eventuella underkataloger. Om du inte anger något itemspecär det här alternativet underförstått.

/remap

/version:<versionspec>

Anger den maximala versionen, eller den lägsta och högsta versionen, som ska visas i historikdata. Standardvärdet är /version:T, den senaste versionen.

Syntax finns i Använda Team Foundation-versionskontrollkommandon.

Kommentarer

  • Om du påbörjar en ny uppgift är det förmodligen en bra idé att köra tf get för att ladda ned de senaste filerna från servern innan du checkar ut filer och påbörjar ditt arbete. Du kan köra tf get från valfri mapp på din arbetsyta.

  • Vid behov tf get skapar du mappar på disken för att innehålla de underordnade objekt som kommandot laddar ned.

  • Du kan visa information om historiken för ett objekt med hjälp av kommandot Historik och kommandot Changeset.

  • Om du är orolig för vilka ändringar som kan inträffa i filerna på arbetsytan kan du använda /preview alternativet för att se de ändringar som skulle inträffa utan att implementera dem.

  • Konflikter kan blockera din get. En vanlig orsak till konflikter är att försöka hämta ett objekt där du har väntande ändringar. Du kan använda kommandot Lös för att lösa dessa konflikter.

Exempel

Följande exempel förutsätter att $/SiteApp/Main/ mappar till c:\code\SiteApp\Main\ i arbetsytan.

Hämta den senaste versionen av alla objekt på en arbetsyta

Som standard tf get hämtar kommandot de senaste versionerna av alla objekt på arbetsytan. Följande kommando hämtar till exempel rekursivt alla filer i $/SiteApp/Main/, inklusive alla underordnade mappar.

c:\code\SiteApp\Main>tf get

Rekursivt hämta den senaste versionen av objekt av en viss typ i en mapp

I följande exempel hämtas den senaste versionen av alla C#-filer i c:\code\SiteApp\Main\SolutionA\Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive

Hämta den senaste versionen av en fil

I följande exempel hämtas den senaste versionen av program.cs i Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs

Hämta en specifik version av en fil

I följande exempel hämtas version 8 av program.cs i Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8

Hämta den senaste versionen av två filer

I följande exempel hämtas de senaste versionerna av file1.cs och file2.cs i Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs

Synkronisera en arbetsyta för att matcha en version av teamets kodbas

I följande exempel synkroniseras arbetsytan så att den matchar kodbasen som den fanns när ändringsuppsättning 15 skapades:

c:\code\SiteApp\Main>tf get /v:15
  • Namnet och innehållet för varje objekt på arbetsytan ändras så att det matchar det tillstånd som fanns på servern.
  • Objekt som har tagits bort efter ändringsuppsättningen återställs till arbetsytan.
  • Objekt som har lagts till efter ändringsuppsättningen tas bort från arbetsytan.

Synkronisera en arbetsyta för att matcha en märkt version av teamets kodbas

I följande exempel synkroniseras arbetsytan så att den matchar objekten i kodbasen som är märkta LastKnownGood:

c:\code\SiteApp\Main>tf get /v:LLastKnownGood
  • Namnet och innehållet för varje märkt objekt på arbetsytan ändras så att det matchar det tillstånd som fanns på servern.
  • Etiketterade objekt som har tagits bort återställs till arbetsytan.
  • Objekt som inte är märkta på servern tas bort från arbetsytan.