Condividi tramite


Comando Get

Aggiornamento: novembre 2007

Recupera una copia in sola lettura di un file dal server Team Foundation e la inserisce nell'area di lavoro creando le cartelle su disco per contenerla.

Autorizzazioni necessarie

Per utilizzare il comando get è necessario disporre dell'autorizzazione Lettura impostata su Consenti per ogni elemento recuperato ed essere proprietario dell'area di lavoro di destinazione o disporre dell'autorizzazione globale Amministra aree di lavoro. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

tf get itemspec [/version:versionspec] [/all] [/overwrite] [/force] 
[/preview] [/recursive] [/remap] [/noprompt]

Parametri

Argomento

Descrizione

Itemspec

File o cartella da recuperare. Se non viene fornito alcun parametro itemspec, in Team Foundation Server viene eseguita un'operazione di lettura ricorsiva dell'area di lavoro corrente.

Versionspec

Valore fornito dall'utente per l'opzione /version. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation Server sulla specifica di una versione per determinare gli elementi all'interno dell'ambito, vedere Sintassi della riga di comando (Team System).

Opzione

Descrizione

/version

Specifica facoltativa della versione. versionspec corrisponde alla versione dell'elemento che si desidera recuperare. È possibile specificare una versione in base a:

  • Data/ora (D2008-01-21T16:00)

  • Versione dell'insieme di modifiche (C1256)

  • Etichetta (Lmylabel)

  • Versione più recente (T)

  • Versione dell'area di lavoro (Wworkspacename;owner)

  • Se non viene fornita alcuna versione, in Team Foundation Server viene recuperata la versione più recente del server del parametro itemspec specificato nell'area di lavoro.

/all

Impone il recupero di tutti i file, non solo di quelli non aggiornati.

/overwrite

Sovrascrive i file scrivibili che non sono estratti.

/force

Combina /all e /overwrite.

/preview

Visualizza ciò che si sarebbe verificato senza l'esecuzione dell'operazione Get.

/recursive

Recupera in modo ricorsivo tutti gli elementi che corrispondono al parametro itemspec.

/remap

Da utilizzare solo con la versione Service Pack 1 di Microsoft Visual Studio Team System 2008 Team Foundation Server.

Aggiorna i riferimenti al database della diramazione rimappata locale per tutti gli elementi il cui contenuto sul disco locale corrisponde al contenuto che si sta scaricando dalla diramazione del controllo della versione.

/noprompt

Disattiva la visualizzazione delle finestre di dialogo che verrebbero altrimenti visualizzate durante questa operazione.

Note

Il comando get consente di recuperare gli elementi dal server in un'area di lavoro. Se non è specificata alcuna versione, viene recuperata la versione più recente del server. Quando si esegue un’operazione get, Team Foundation Server determina l'eliminazione dal server degli eventuali file contrassegnati per l'eliminazione a livello locale e sottoposti ad archiviazione dopo l'ultima volta in cui l'area di lavoro è stata sincronizzata con il server. I file rinominati o spostati sul server vengono riposizionati sul disco in modo da ottenere una corrispondenza con le modifiche apportate sul server. I file rinominati o spostati sul server vengono inoltre spostati nell'area di lavoro locale in modo da ottenere una corrispondenza con le modifiche apportate sul server.

Il comando get non comporta la sovrascrittura dei file estratti nella directory dell'area di lavoro locale. Quando si esegue un comando get per un elemento che è già stato estratto nell'area di lavoro e la versione del server è cambiata, verrà richiesto di risolvere i conflitti dei file tra la versione dell'area di lavoro e la versione del server. Per ulteriori informazioni, vedere Comando Resolve.

  • Utilizzare l'opzione /all se la versione dell'area di lavoro è identica a quella del server richiesta e si desidera sostituire il file su disco.

  • Utilizzare l'opzione /overwrite per sovrascrivere forzatamente la versione modificabile dell'area di lavoro corrente con una versione del server specificata.

  • Utilizzare l'opzione /force per sovrascrivere tutti gli elementi estratti nell'area di lavoro con l'ultima versione del server. Per sovrascrivere una versione specifica è inoltre possibile utilizzare l'opzione /force.

  • Per visualizzare le modifiche che si verificheranno durante la successiva operazione get, utilizzare l'opzione /preview.

Nota:

Utilizzare spesso il comando get per tenere aggiornata l'area di lavoro e poter risolvere rapidamente le differenze tra la propria versione di un progetto e quella del server.

Per informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.

Utilizzo di Get con l'opzione /remap

L'opzione /remap consente di ridurre i tempi di download quando si esegue un nuovo mapping di una cartella locale a una diramazione nuova o diversa. Esempio:

  1. Si esegue il mapping di $/branch1 a D:\branch sul computer.

  2. Si esegue tf get per ottenere una copia di tutti gli elementi da $/branch1 alla cartella locale.

  3. Si modifica il mapping di $/branch1 e si esegue il mapping di $/branch2 alla cartella locale precedentemente mappata come $/branch1 (D:\branch).

  4. Si esegue tf get con l'opzione /remap per scaricare solo il contenuto di $/branch2 che differisce dal contenuto in $/branch1 nella cartella locale (D:\branch).

Nota:

Questa funzionalità è disponibile soltanto se è installata la versione Service Pack 1 di Microsoft Visual Studio Team System 2008 Team Foundation Server.

Esempi

L'esempio riportato di seguito consente di recuperare la versione più recente di 314.cs dal server. In presenza di modifiche in sospeso rispetto a 314.cs, in Team Foundation Server viene chiesto di risolvere i conflitti.

C:\projects>tf get 314.cs

L'esempio riportato di seguito consente di recuperare la versione 8 di 1256.cs dal server.

Nota:

L'utilizzo di 1256.cs;8 equivale all'utilizzo di 1256.cs;C8. Per impostazione predefinita, se dopo il punto e virgola si specifica solo un numero, viene utilizzata la versione dell'insieme di modifiche.

C:\>tf get 1256.cs;8

Nell'esempio riportato di seguito vengono recuperate le versioni più recenti di tutti gli elementi non mascherati dalla cartella e dalle sottocartelle del server nella directory C:\projects e, laddove necessario, vengono create le cartelle locali. Per ulteriori informazioni su come mascherare e rendere visibili le cartelle, vedere Comando Workfold.

C:\projects>tf get

Gli esempi riportati di seguito rappresentano metodi alternativi per il recupero della versione di 1256.cs archiviata con l'insieme di modifiche 1999.

c:\projects>tf get /version:C1999 1256.cs

oppure

c:\projects>tf get 1256.cs;C1999

L'esempio riportato di seguito consente di recuperare dal server la versione di tutti gli elementi non mascherati disponibili sul server quando è stato creato l'insieme di modifiche 271.

c:\projects>tf get /version:C271

L'esempio riportato di seguito consente di recuperare build42, con etichetta “build42". In questo modo l'area di lavoro viene associata all'etichetta, purché non vi siano modifiche in sospeso. Qualsiasi file non nell'etichetta viene rimosso dal disco locale.

c:\projects>tf get /version:Lbuild42

Nell'esempio seguente viene recuperata la versione esistente sul server corrispondente a una data e un'ora specifiche.

c:\projects>tf get /version:D2008-01-21T16:00

Vedere anche

Attività

Procedura dettagliata: utilizzo del controllo delle versioni di Team Foundation dalla riga di comando

Procedura: ottenere il codice sorgente per il progetto team

Procedura: mascherare e rendere visibili le cartelle in un'area di lavoro

Riferimenti

Comando Resolve

Comando Merge

Comandi Checkout ed Edit

Comando Checkin

Comando Unshelve

Comando Workfold

Altre risorse

Comandi dell'utilità della riga di comando Tf