Opdracht Ophalen (Team Foundation Version Control)

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

Visual Studio 2019 | Visual Studio 2022

Met de opdracht Team Foundation Version Control (TFVC) get wordt de nieuwste versie of een opgegeven versie van een of meer bestanden of mappen van Azure DevOps Server naar de werkruimte opgehaald of gedownload. De tf get opdracht biedt een andere gebruikersinterface dan Visual Studio, maar het proces is fundamenteel hetzelfde. Zie Bestanden downloaden (ophalen) van de server voor meer informatie over het gebruik van Visual Studio om bestanden en mappen op te halen.

Vereisten

Zie Standaard TFVC-machtigingen.

Syntaxis

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

Parameters

Parameter

Beschrijving

/all

U kunt deze optie gebruiken om een item te herstellen dat u per ongeluk hebt verwijderd uit een serverwerkruimte. Als u een lokale werkruimte gebruikt, wat wordt aanbevolen, is het onwaarschijnlijk dat u deze optie moet gebruiken.

TFVC onderhoudt een interne record van alle items die de werkruimte bevat, inclusief de versie van elke. Wanneer u bestanden krijgt, als de interne record op de server aangeeft dat de werkruimte al de versie heeft die u krijgt, wordt het item niet opgehaald. Met deze optie worden alle items opgehaald, ongeacht de gegevens die de interne record bevat.

/force

Combineert /all en /overwrite.

<itemspec>

Hiermee geeft u het bereik van de items op die moeten worden get. U kunt meer dan één itemspec argument opgeven. Als er geen itemspec is opgegeven, haalt het systeem recursief alle items op in de huidige werkruimte.

Zie Team Foundation-opdrachten voor versiebeheer gebruiken voor syntaxis.

/login <username>,[<password>]

Hiermee geeft u het gebruikersaccount om de opdracht uit te voeren. Zie Opdrachten voor versiebeheer van Team Foundation gebruiken.

/noautoresolve

Het systeem probeert standaard automatisch alle conflicten opnieuw op te lossen. Zie Team Foundation-versiebeheerconflicten oplossen voor meer informatie. Geef deze optie op om dit standaardgedrag uit te schakelen.

/noprompt

Onderdrukt de weergave van Visual Studio-vensters en dialoogvensters en stuurt uitvoergegevens om naar de opdrachtprompt. Zie Opdrachten voor versiebeheer van Team Foundation gebruiken.

/overwrite

Het systeem haalt standaard geen item op als het beschrijfbaar is, dat is het kenmerk Alleen-lezen op de clientcomputer. Met deze optie wordt het standaardgedrag overschreven en wordt een beschrijfbaar item overschreven, tenzij het item is uitgecheckt. Als u een lokale werkruimte gebruikt zoals aanbevolen, is het onwaarschijnlijk dat u deze optie moet gebruiken.

/preview

Geeft weer wat er zou gebeuren, zonder de bewerking daadwerkelijk uit te get voeren.

/recursive

Recursief haalt items op in de opgegeven map en eventuele submappen. Als u geen optie opgeeft itemspec, wordt deze optie geïmpliceerd.

/remap

Zie de blog van phkelley: tf get /remap.

/version:<versionspec>

Hiermee geeft u de maximale versie, of het minimum en de maximumversies, op om weer te geven in de geschiedenisgegevens. De standaardwaarde is /version:T, de nieuwste versie.

Zie Team Foundation-opdrachten voor versiebeheer gebruiken voor syntaxis.

Opmerkingen

• Als u een nieuwe taak begint, is het waarschijnlijk een goed idee om de meest recente bestanden van de server te tf get downloaden voordat u bestanden uitcheckt en begint met uw werk. U kunt uitvoeren tf get vanuit elke map in uw werkruimte.

• Indien nodig maakt tf get u mappen op de schijf om de onderliggende items te bevatten die door de opdracht worden gedownload.

• U kunt informatie over de geschiedenis van een item weergeven met behulp van de opdracht Geschiedenis en de opdracht Wijzigingenset.

• Als u zich zorgen maakt over welke wijzigingen in de bestanden in de werkruimte kunnen optreden, kunt u de /preview optie gebruiken om de wijzigingen te zien die zouden optreden zonder ze daadwerkelijk te implementeren.

• Conflicten kunnen uw get. Een typische oorzaak van conflicten is het ophalen van een item waarvoor u wijzigingen in behandeling hebt. U kunt de opdracht Oplossen gebruiken om deze conflicten op te lossen.

Voorbeelden

In de volgende voorbeelden wordt ervan uitgegaan dat deze $/SiteApp/Main/ wordt toegewezen c:\code\SiteApp\Main\ in de werkruimte.

De nieuwste versie van alle items in een werkruimte ophalen

De opdracht krijgt standaard tf get de nieuwste versies van alle items in de werkruimte. Met de volgende opdracht worden bijvoorbeeld recursief alle bestanden in $/SiteApp/Main/, inclusief alle onderliggende mappen, opgeslagen.

c:\code\SiteApp\Main>tf get

Recursief de nieuwste versie van items van een bepaald type in een map ophalen

In het volgende voorbeeld wordt de nieuwste versie van alle C#-bestanden in c:\code\SiteApp\Main\SolutionA\Project1 weergegeven.

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

De nieuwste versie van een bestand ophalen

In het volgende voorbeeld wordt de nieuwste versie van program.cs in Project1 weergegeven.

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

Een specifieke versie van een bestand ophalen

In het volgende voorbeeld wordt versie 8 van program.cs in Project1 opgeslagen.

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

De nieuwste versie van twee bestanden ophalen

In het volgende voorbeeld worden de nieuwste versies van file1.cs en file2.cs in Project1 weergegeven.

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

Een werkruimte synchroniseren zodat deze overeenkomt met een versie van de codebasis van het team

In het volgende voorbeeld wordt de werkruimte gesynchroniseerd zodat deze overeenkomt met de codebasis, omdat deze bestond toen er wijzigingenset 15 werd gemaakt:

c:\code\SiteApp\Main>tf get /v:15

• De naam en inhoud van elk item in de werkruimte wordt gewijzigd zodat het overeenkomt met de status waarin het item zich op de server bevindt.
• Items die na die wijzigingenset zijn verwijderd, worden teruggezet naar de werkruimte.
• Items die na die wijzigingenset zijn toegevoegd, worden uit de werkruimte verwijderd.

Een werkruimte synchroniseren zodat deze overeenkomt met een gelabelde versie van de codebasis van het team

In het volgende voorbeeld wordt de werkruimte gesynchroniseerd zodat deze overeenkomt met de items in de codebasis die zijn gelabeldLastKnownGood:

c:\code\SiteApp\Main>tf get /v:LLastKnownGood

• De naam en inhoud van elk gelabeld item in de werkruimte wordt gewijzigd zodat deze overeenkomt met de status waarin het item zich op de server bevindt.
• Gelabelde items die zijn verwijderd, worden teruggezet naar de werkruimte.
• Items die niet op de server zijn gelabeld, worden verwijderd uit de werkruimte.