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:
|
/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.
.gif "Nota") 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:
Si esegue il mapping di $/branch1 a D:\branch sul computer.
Si esegue tf get per ottenere una copia di tutti gli elementi da $/branch1 alla cartella locale.
Si modifica il mapping di $/branch1 e si esegue il mapping di $/branch2 alla cartella locale precedentemente mappata come $/branch1 (D:\branch).
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: ottenere il codice sorgente per il progetto team
Procedura: mascherare e rendere visibili le cartelle in un'area di lavoro