Condividi tramite

Riferimenti ai comandi del controllo della versione di Team Foundation

  • Articolo

È possibile utilizzare i comandi di controllo della versione per eseguire quasi tutte le attività che è possibile eseguire in Visual Studio e anche diverse attività che non possono essere effettuate in Visual Studio.È possibile utilizzare lo strumento tf.exe per eseguire i comandi di controllo della versione da un prompt dei comandi o in uno script.

Scegliere l'argomento con cui si desidera procedere

  • Eseguire un comando

    • Configurazione del computer di sviluppo

    • Sviluppare le app

    • Sospendere il proprio lavoro

    • Contribuire con il proprio lavoro

    • Gestire i file e risolvere i problemi

    • Isolare il rischio

  • Capire la sintassi del comando

  • Specificare gli elementi interessati da un comando

    • Utilizzare un argomento itemspec per specificare gli elementi interessati

    • Utilizzare un argomento versionspec per specificare le versioni interessate degli elementi

  • Utilizzare le opzioni per modificare la funzionalità di un comando

    • Utilizzare l'opzione /noprompt per eliminare le richieste per l'immissione dei dati e reindirizzare i dati di output sulla finestra del prompt dei comandi

    • Utilizzare l'opzione /login per specificare le credenziali quando si esegue un comando

    • Utilizzare l'opzione /lock per applicare o rimuovere un blocco

    • Utilizzare scorciatoie di opzione

  • Comprendere i codici di uscita

Eseguire un comando

Per avviare il prompt dei comandi di Visual Studio, da Windows Avvia, scegliere Microsoft Visual Studio 2012, Strumenti Visual Studio quindi scegliere uno dei collegamenti Prompt dei comandi.

Nella maggior parte dei casi, si esegue il comando di controllo della versione nel contesto di una cartella mappata nell'area di lavoro.Ad esempio, $/SiteApp/Main/ mappato a c:\code\SiteApp\Main\.Per ottenere la versione più recente di tutti gli elementi dell'area di lavoro:

c:\code\SiteApp\Main\SolutionA>tf get

[!NOTA]

Attualmente non vengono resi pubblici alcuni degli argomenti.Tuttavia, è possibile leggere la versione Visual Studio 2010 di questi argomenti.

cc31bk2e.collapse_all(it-it,VS.110).gifConfigurazione del computer dello sviluppatore e gestione delle aree di lavoro

L'area di lavoro è una copia locale del codebase del team.Poiché è una copia locale del computer dello sviluppatore, è possibile sviluppare e testare il codice in isolamento finché non si è pronti per consegnare il lavoroDi seguito sono riportati alcuni comandi per gestire l'area di lavoro:

Vedere anche: Configurare il computer dello sviluppatore e iniziare a utilizzare il controllo della versione, Gestire le aree di lavoro

cc31bk2e.collapse_all(it-it,VS.110).gifSviluppare le app

Utilizzare questi controlli per compilare l'applicazione sotto controllo della versione con il team:

Vedere anche: Sviluppare le app in un codebase controllato dalla versione

cc31bk2e.collapse_all(it-it,VS.110).gifSospendere il proprio lavoro

Per diverse ragioni, talvolta è necessario invalidare alcuni o tutti il lavoro in corso.Per sospendere e riprendere il lavoro e gestire le shelveset, utilizzare questi comandi:

Vedere anche: Sospendere il lavoro e gestire le shelveset.

cc31bk2e.collapse_all(it-it,VS.110).gifContribuire con il proprio lavoro

Di seguito viene illustrato come archiviare il codice sul codebase team:

  • Comando Checkin
    Archivia le modifiche in sospeso ai file o alle cartelle sul server.

Vedere anche: Archiviare il proprio lavoro nel codebase del team

cc31bk2e.collapse_all(it-it,VS.110).gifGestire i file e risolvere i problemi

cc31bk2e.collapse_all(it-it,VS.110).gifIsolare il rischio

Utilizzare i comandi seguenti per ridurre il rischio introdotto utilizzando branches:

Vedere anche: Isolare il rischio tramite il branch.

cc31bk2e.collapse_all(it-it,VS.110).gifAmministrare il controllo della versione

Utilizzare i comandi seguenti per amministrare il sistema di controllo della versione:

Vedere anche: Amministrazione del controllo della versione di Team Foundation (Visual Studio 2010).

cc31bk2e.collapse_all(it-it,VS.110).gifOttenere la guida sui comandi di controllo della versione

Utilizzare i comandi seguenti per ottenere ulteriori informazioni sui comandi di controllo della versione:

Capire la sintassi del comando

La sintassi di ogni comando viene visualizzata all'inizio di ogni argomento di riferimento.

cc31bk2e.collapse_all(it-it,VS.110).gifArgomenti obbligatori e facoltativi

Gli argomenti privi di parentesi sono necessari.[Brackets] indica gli argomenti facoltativi non necessari per completare un comando.Tuttavia, alcuni argomenti facoltativi hanno impostazioni predefinite applicate al comando anche se non si specifica l'opzione.

cc31bk2e.collapse_all(it-it,VS.110).gifArgomenti esclusivi

Quando le opzioni sono separate dalle pipe (|), è possibile specificare una delle opzioni.

cc31bk2e.collapse_all(it-it,VS.110).gifArgomenti verbatim e sostituibili

Gli elementi in grassetto sono opzioni che si includono come stringhe letterali.Gli elementi di Formattati in corsivo sono argomenti che è necessario sostituire con i caratteri per eseguire un comando.

cc31bk2e.collapse_all(it-it,VS.110).gifCollegamenti e alias dei comandi

Alcuni comandi supportano delle scorciatoie.Ad esempio, è possibile chiamare Comando di eliminazione con tf delete o tf del.

cc31bk2e.collapse_all(it-it,VS.110).gifEsempio

Ad esempio, il Comando estrai:

tf checkout [/lock:( none|checkin|checkout)] [/recursive] itemspec [/login: username,[ password]]

Rivediamo gli argomenti in questo esempio:

  • itemspec: È necessario sostituire questo argomento con itemspec che specifica gli elementi che vengono estratti.

  • /lock:(none|checkin|checkout): Non è necessario specificare l'opzione /lock.Se non viene specificato, il sistema per impostazione predefinita specifica /lock:none.In caso contrario, è possibile specificare una delle opzioni di blocco.

  • Gli argomenti sono facoltativi e se non vengono forniti, nessuno dei relativi effetti viene applicano al comando:

    • /recursive: Se si vuole eseguire in modo ricorsivo l'estrazione degli elementi in una cartella, è necessario specificare questa opzione verbatim.

    • /login:nome utente,password: Se si desidera eseguire il comando come utente diverso, è necessario specificare l'opzione /login sostituendo nome utente con il nome dell'utente e, se necessario, è possibile fornire la password.

Specificare gli elementi interessati da un comando

È possibile utilizzare itemspecs e versionspec per specificare quali elementi sono interessati da un comando.

cc31bk2e.collapse_all(it-it,VS.110).gifUtilizzare un argomento itemspec per specificare gli elementi interessati

Utilizzare itemspec (specifica dell'elemento) per specificare gli elementi interessati da un comando.È possibile specificare gli elementi in un computer client o sul Team Foundation Server.È possibile utilizzare i caratteri jolly come * e ?.

cc31bk2e.collapse_all(it-it,VS.110).gifArgomenti client itemspec

Un argomento client itemspec specifica un percorso agli elementi in un computer client come una cartella, (ad esempio c:\code\SiteApp\Main\SolutionA\) un file (ad esempio, c:\code\SiteApp\Main\SolutionA\Project1\program.cs o più file (ad esempio, c:\code\SiteApp\Main\SolutionA\*.cs.È inoltre possibile specificare percorsi UNC come \\myshare\code\SiteApp\Main.

cc31bk2e.collapse_all(it-it,VS.110).gifArgomenti server itemspec

Un argomento itemspec del server specifica un percorso agli elementi del Team Foundation Server come una cartella, (ad esempio $/SiteApp/Main/SolutionA) un file (ad esempio, $/SiteApp/Main/SolutionA/Project1/program.cs o più file (ad esempio, $/SiteApp/Main/SolutionA/*.cs.

In genere si utilizzano gli argomenti itemspec del server quando si ha bisogno di eseguire un comando sugli elementi non sul computer client.Ad esempio, si sta lavorando su un computer dello sviluppatore ed è necessario ottenere dati di cronologia revisioni su alcuni elementi in una raccolta di progetti team su i quali non si lavora:

c:\>tf history /collection:http://fabrikam-3:8080/tfs/DefaultCollection
$/SiteApp/Main/SolutionA/Project1/* /recursive  
/noprompt

cc31bk2e.collapse_all(it-it,VS.110).gifPiù argomenti itemspec

Per alcuni comandi, è possibile specificare più argomenti itemspec.Ad esempio:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Esegue l'estrazione di program.cs e. program2.c.

cc31bk2e.collapse_all(it-it,VS.110).gifUtilizzare un argomento versionspec per specificare le versioni interessate degli elementi

Utilizzare versionspec (specifica della versione) per specificare la versione degli elementi interessati da un comando.Per fornire versionspec è possibile:

  • Utilizzare l'opzione /version.Ad esempio: /version:C44.

  • Aggiungere l'elemento versionspec a un itemspec con un punto e virgola.Ad esempio: program1.cs;C44.

Quando si utilizzano i comandi Comando History o Difference Command, è possibile specificare un intervallo di versioni separando le versioni tramite un carattere tilde (~).Ad esempio:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012

Utilizzare la sintassi seguente per specificare versionspec.

Type

Sintassi

Descrizione

Insieme di modifiche

[C]n

Specifica gli elementi in base al numero dell' insieme di modificheSe un elemento che si trova nell'ambito non è stato modificato nell'insieme di modifiche specificato, il sistema accetta la versione più recente dell'elemento che si è verificato prima dell'insieme di modifiche specifico.

SuggerimentoSuggerimento
È possibile omettere C se si specifica solo un numero.

Esempi

c:\code\SiteApp\Main>tf get readme.txt /v:C8

--oppure--

c:\code\SiteApp\Main>tf get readme.txt /v:8

--oppure--

c:\code\SiteApp\Main>tf get readme.txt;8

Se readme.txt è stato modificato nell'insieme di modifiche 8, ottiene quella versione del file.In caso contrario, recupera la versione più recente di readme.txt prima della versione 8.

Etichetta

Llabel

Specifica gli elementi a cui label è stato applicato.

Esempi

c:\code\SiteApp\Main>tf get readme.txt;LJulyHotFix

Ottiene la versione di readme.txt contrassegnata JulyHotFix.

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

Recupera la versione di tutti gli elementi contrassegnati (ed elimina tali elementi non contrassegnati) nell'area di lavoro come esistenti quando l'insieme di modifiche contrassegnato come LastKnownGood è stato creato, ad esempio, come parte di un processo di compilazione automatizzato.

Data e ora

Dyyyy-mm-ddTxx:xx

-oppure-

Dmm/dd/yyyy

-oppure-

Qualsiasi formato supportato di .NET Framework.

-oppure-

Uno dei formati di data supportati sul computer locale.

Specifica un insieme di modifiche creato ad una data e un'ora specificata.

Esempi

c:\code\SiteApp\Main>tf get /version:D2004-03-22

Aggiorna l'area di lavoro a quella del codebase com'era il 3/22/2004 alle 00:00 (mezzanotte).

c:\code\SiteApp\Main>tf get /version:D2004-03-22T09:00

Aggiorna l'area di lavoro a quella del codebase com'era il 3/22/2004 alle 09:00 (9 AM).

Per ulteriori informazioni sui formati supportati da .NET Framework vedere DateTime e Stringhe di formato di data e ora standard.

Area di lavoro (corrente)

W

Specifica la versione nell'area di lavoro.

Area di lavoro (specificata)

Wworkspacename; workspaceowner

Specifica la versione in un'area di lavoro specificata.

Ad esempio: WResolveRIConflicts;PeterW

Suggerimento

T

Specifica la versione più recente.

Utilizzare le opzioni per modificare la funzionalità di un comando

È possibile utilizzare alcune opzioni comuni per la modifica la funzionalità di un comando.

cc31bk2e.collapse_all(it-it,VS.110).gifUtilizzare l'opzione /noprompt per eliminare le richieste per l'immissione dei dati e reindirizzare i dati di output sulla finestra del prompt dei comandi

Utilizzare l'opzione /noprompt eliminare le richieste per l'immissione dei dati e reindirizzare i dati di output sulla finestra del prompt dei comandi.Questa opzione può essere utile quando è necessario utilizzare i comandi di controllo della versione in uno script poiché il comando continua senza l'intervento di un utente e i dati sono disponibili per lo script che può eseguire eseguire operazioni come l'analisi (parsing) o l'acquisizione.

Quando si utilizza questa opzione, il sistema:

  • Rimuove tutte le richieste di input:

    • Nessuna richiesta viene fatta nella finestra del prompt dei comandi.Ad esempio, quando si utilizza Comando Undo con questa opzione, il sistema non chiede di confermare se si desidera eventualmente annullare le modifiche.

    • Non compaiono finestre o finestre di dialogo.Ad esempio, è possibile utilizzare questa opzione con Comando Checkin.Anziché visualizzare una finestra di dialogo Archivia per confermare le opzioni (quali gli elementi che si desidera archiviare o quali elementi di lavoro associare), il sistema procede con l'archiviazione senza conferma.

  • Reindirizza i dati di output al prompt dei comandi.Ad esempio, è possibile utilizzare questa opzione con Comando History.I dati vengono visualizzati nella finestra del prompt dei comandi anziché nella Finestra della cronologia.

cc31bk2e.collapse_all(it-it,VS.110).gifUtilizzare l'opzione /login per specificare le credenziali quando si esegue un comando

Utilizzare l'opzione /login per specificare l'account utente di Team Foundation Server per eseguire un comando.Questa opzione può essere utile quando si utilizza il computer di un altro membro del team.

Ad esempio, Julia sta lavorando con Peter al suo computer di sviluppatore.Lei utilizza il Comando di blocco per sbloccare un file che ha precedentemente bloccato:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI,JuliaPassword

Se lei desiderasse evitare che la password venga visualizzata nel prompt dei comandi, può inserire il comando senza la password:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI

Dopo che questo comando è stato inserito, il sistema richiede di inserire la password in una finestra di dialogo che maschera il relativo input.

cc31bk2e.collapse_all(it-it,VS.110).gifUtilizzare l'opzione /lock per applicare o rimuovere un blocco

Nota importanteImportante

È consigliabile utilizzare l'opzione /lock con discrezione e informare i colleghi del team dei motivi per i quali viene bloccato un elemento, fornendo una stima dei tempi di rimozione del blocco.

Utilizzare l'opzione /lock per applicare o rimuovere un blocco allo stesso tempo che si esegue un altro comando come Aggiungi o Modifica.

/lock:(none|checkin|checkout)

  • None: Nessun blocco è collocato su un elemento.Se un blocco è già in posizione viene rimosso.

  • Checkin o Checkout: applica un blocco.Vedere Informazioni sui tipi di blocco.

[!NOTA]

In alcuni casi, l'operazione di blocco può non riuscire:

  • Se uno degli altri utenti ha bloccato uno qualunque degli oggetti specificati, l'operazione di blocco non viene eseguita.

  • Il sistema ignora questa opzione se esiste già una modifica in sospeso all'elemento.In questo caso, è necessario utilizzare Lock Command per modificare un blocco su un elemento.

cc31bk2e.collapse_all(it-it,VS.110).gifUtilizzare scorciatoie di opzione

È possibile dare una abbreviazione delle seguenti opzioni:

Opzione

Alias opzione

/comment

-C

/computer

-M

/delete

-D

/force

-P

/format

-F

/help

-?, -H

/lock

-K

/login

-Y

/newname

-N

/noprompt

-I

/owner

-O

/recursive

-R

/server

-S

/slotmode

-X

/template

-T

/user

-U

/version

-V

/workspace

-W

Comprendere i codici di uscita

I comandi di controllo della versione restituiscono i seguenti codici di uscita:

Codice di uscita

Definizione

0

Riuscita.

1

Riuscita parziale; indica che alcune operazioni, o la totalità di esse, non sono riuscite.

2

Comando non riconosciuto.

100

Nessuna operazione riuscita.

Ad esempio:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Se uno dei file che si sta tentando di estrarre non esiste nel server, il comando restituisce 1 per indicare la riuscita parziale.