Comando Get (controllo della versione di Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

Il comando controllo della versione di Team Foundation (TFVC) get ottiene o scarica la versione più recente o una versione specificata di uno o più file o cartelle da Azure DevOps Server all'area di lavoro. Il tf get comando fornisce un'interfaccia utente diversa da Visual Studio, ma il processo è fondamentalmente lo stesso. Per altre informazioni sull'uso di Visual Studio per ottenere file e cartelle, vedere Scaricare (ottenere) file dal server.

Prerequisiti

Vedere Autorizzazioni tfvc predefinite.

Sintassi

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

Parametri

Parametro

Descrizione

/all

È possibile usare questa opzione per ripristinare un elemento eliminato accidentalmente da un'area di lavoro server. Se si usa un'area di lavoro locale, consigliata, è improbabile che sia necessario usare questa opzione.

TFVC mantiene un record interno di tutti gli elementi contenuti nell'area di lavoro, inclusa la versione di ogni elemento. Per impostazione predefinita, quando si ottengono file, se il record interno nel server indica che l'area di lavoro ha già la versione ottenuta, non recupera l'elemento. Questa opzione ottiene tutti gli elementi indipendentemente dai dati contenuti nel record interno.

/force

Combina /all e /overwrite.

<itemspec>

Specifica l'ambito degli elementi da ottenere. È possibile specificare più itemspec argomenti. Se non viene specificato alcun valore itemspec , il sistema ottiene in modo ricorsivo tutti gli elementi nell'area di lavoro corrente.

Per la sintassi, vedere Usare i comandi di controllo della versione di Team Foundation.

/login <username>,[<password>]

Specifica l'account utente per eseguire il comando. Vedere Usare i comandi di controllo della versione di Team Foundation.

/noautoresolve

Per impostazione predefinita, il sistema tenta automaticamente di risolvere tutti i conflitti. Per altre informazioni, vedere Risolvere i conflitti di controllo della versione di Team Foundation. Specificare questa opzione per disabilitare questo comportamento predefinito.

/noprompt

Elimina la visualizzazione delle finestre e delle finestre di dialogo di Visual Studio e reindirizza i dati di output al prompt dei comandi. Vedere Usare i comandi di controllo della versione di Team Foundation.

/overwrite

Per impostazione predefinita, il sistema non recupera un elemento se è scrivibile, ovvero il relativo attributo di sola lettura viene cancellato nel computer client. Questa opzione esegue l'override del comportamento predefinito e sovrascrive un elemento scrivibile, a meno che l'elemento non sia estratto. Se si usa un'area di lavoro locale come consigliato, è improbabile che sia necessario usare questa opzione.

/preview

Visualizza ciò che si verificherebbe, senza eseguire effettivamente l'operazione get .

/recursive

Ottiene in modo ricorsivo gli elementi nella directory specificata ed eventuali sottodirectory. Se non si specifica un , itemspecquesta opzione è implicita.

/remap

Vedere il blog di phkelley: tf get /remap.

/version:<versionspec>

Specifica la versione massima o minima e la versione massima da visualizzare nei dati della cronologia. Il valore predefinito è /version:T, la versione più recente.

Per la sintassi, vedere Usare i comandi di controllo della versione di Team Foundation.

Osservazioni:

• Se si sta iniziando una nuova attività, probabilmente è consigliabile eseguire tf get per scaricare i file più recenti dal server prima di archiviare i file e iniziare il lavoro. È possibile eseguire tf get da qualsiasi cartella nell'area di lavoro.

• Se necessario, tf get crea cartelle su disco per contenere gli elementi figlio scaricati dal comando.

• È possibile visualizzare informazioni sulla cronologia di un elemento usando il comando Cronologia e il comando Set di modifiche.

• Se si è preoccupati delle modifiche apportate ai file nell'area di lavoro, è possibile usare l'opzione /preview per visualizzare le modifiche che verrebbero apportate senza implementarle effettivamente.

• I conflitti potrebbero bloccare l'oggetto get. Una causa tipica di conflitti consiste nel tentare di ottenere un elemento in cui sono presenti modifiche in sospeso. È possibile usare il comando Risolvi per risolvere questi conflitti.

Esempi

Gli esempi seguenti presuppongono che $/SiteApp/Main/ eseponga il mapping a c:\code\SiteApp\Main\ nell'area di lavoro.

Ottenere la versione più recente di tutti gli elementi in un'area di lavoro

Per impostazione predefinita, il tf get comando ottiene le versioni più recenti di tutti gli elementi nell'area di lavoro. Ad esempio, il comando seguente ottiene in modo ricorsivo tutti i file in $/SiteApp/Main/, incluse tutte le relative cartelle figlio.

c:\code\SiteApp\Main>tf get

Ottenere in modo ricorsivo la versione più recente degli elementi di un determinato tipo in una cartella

L'esempio seguente ottiene la versione più recente di tutti i file C# in c:\code\SiteApp\Main\SolutionA\Project1.

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

Ottenere la versione più recente di un file

Nell'esempio seguente viene recuperata la versione più recente di program.cs in Project1.

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

Ottenere una versione specifica di un file

Nell'esempio seguente viene recuperata la versione 8 di program.cs in Project1.

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

Ottenere la versione più recente di due file

Nell'esempio seguente vengono recuperate le versioni più recenti di file1.cs e file2.cs in Project1.

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

Sincronizzare un'area di lavoro in modo che corrisponda a una versione della codebase del team

L'esempio seguente sincronizza l'area di lavoro in modo che corrisponda alla codebase esistente quando è stato creato il set di modifiche 15:

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

• Il nome e il contenuto di ogni elemento nell'area di lavoro vengono modificati in modo che corrispondano allo stato in cui si trovava nel server.
• Gli elementi eliminati dopo tale insieme di modifiche vengono ripristinati nell'area di lavoro.
• Gli elementi aggiunti dopo il set di modifiche vengono eliminati dall'area di lavoro.

Sincronizzare un'area di lavoro in modo che corrisponda a una versione etichettata della codebase del team

Nell'esempio seguente l'area di lavoro viene sincronizzata in modo che corrisponda agli elementi della codebase con LastKnownGoodetichetta :

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

• Il nome e il contenuto di ogni elemento etichettato nell'area di lavoro vengono modificati in modo che corrispondano allo stato in cui si trovava nel server.
• Gli elementi etichettati eliminati vengono ripristinati nell'area di lavoro.
• Gli elementi non etichettati nel server vengono eliminati dall'area di lavoro.