Condividi tramite


Sintassi della riga di comando (controllo della versione)

Di seguito viene illustrata la sintassi del comando tf dell'utilità della riga di comando Team Foundation:

tf command item [/options]

In questo argomento vengono descritte le convenzioni adottate nella documentazione, i collegamenti ai comandi, i caratteri speciali della riga di comando e i parametri specifici di Team Foundation, versionspec e itemspec.

Convenzioni della documentazione

[/Brackets] indica opzioni non obbligatorie per il completamento di un comando. Gli elementi non racchiusi tra parentesi quadre indicano parametri necessari per il completamento dell'operazione. Ad esempio, nel seguente comando itemspec è obbligatorio e /recursive è facoltativo:

Esempio di sintassi: c:\projects>tf getitemspec [/recursive]

Comando effettivo: c:\projects>tf get c:\projects /recursive

Comando alternativo: c:\projects>tf get /recursive

Nell'esempio di Comando alternativo, Team Foundation deduce che si intende leggere il contenuto della directory corrente, c:\projects, e di tutte le relative sottocartelle. Quindi, anche se il parametro itemspec è obbligatorio, non deve essere necessariamente digitato.

Quando due, pipe (**|**opzioni separate dal carattere pipe () sono racchiuse tra parentesi, è possibile specificare una delle opzioni ma non entrambe. Ad esempio, tf Changeset [/comment:commento|@filecommento] indica che è possibile digitare un commento per Insieme di modifiche dopo l'opzione /comment: o ( |) è possibile utilizzare la sintassi **@**filecommento per specificare il percorso di un file contenente un commento che si desidera utilizzare. Tuttavia, non è possibile specificare sia commento sia filecommento.

Negli esempi di sintassi, gli elementi visualizzati in corsivo sono parametri che devono essere sostituiti con caratteri reali per eseguire un comando. Gli elementi in grassetto sono opzioni che si includono come stringhe letterali. Di seguito è riportato un esempio.

Esempio di sintassi: tf shelvesetsshelvesetname [/recursive]

Comando effettivo: c:\projects>tf shelvesets BuddyTest_23

Caratteri speciali della riga di comando

È possibile utilizzare il carattere "@", ovvero l'opzione del file di comando, per eseguire simultaneamente un set di comandi Team Foundation. Il vantaggio principale dell'utilizzo di un'opzione della riga di comando dal prompt dei comandi, da un file di comando o in un file batch o di script, consiste nel fatto che utilizzare un'opzione della riga di comando può essere molto più rapido dell'esecuzione dei singoli comandi. Per ulteriori informazioni, vedere Opzioni della riga di comando.

Collegamenti e alias dei comandi

I collegamenti e gli alias dei comandi definiti di seguito sono supportati per l'utilità della riga di comando tf.

  • del = elimina

  • diff = differenza

  • edit = estrazione

  • hist = cronologia

  • perm = autorizzazione

  • prop = proprietà

  • ren = rinomina

  • rename = sposta

  • stat = stato

  • undel = annulla eliminazione

Per ulteriori informazioni sui precedenti comandi, vedere Comandi dell'utilità della riga di comando Tf.

Procedure di Team Foundation per l'analisi di oggetti itemspec e versionspec

Percorsi itemspec

Un itemspec (abbreviazione di "specifica dell'elemento") è un insieme di uno o più caratteri che Team Foundation tenta di risolvere come elemento indirizzabile o set di elementi, sul computer o sul server di controllo della versione.

Per tutti i comandi Team Foundation che accettano un oggetto itemspec, è possibile specificare percorsi del file system locale, ad esempio c:\progetti, percorsi UNC come \\condivisione\progetti oppure percorsi del server come $/progetti/mieifile.

Per i percorsi locali, è possibile fornire i relativi percorsi. Ad esempio, se la directory corrente è c:\progetti e si desidera estrarre tutti gli elementi presenti in una sottodirectory della cartella progetti, è possibile digitare tf checkout .\* /recursive.

SuggerimentoSuggerimento

I comandi Controllo della versione di Team Foundation consentono l'utilizzo dei caratteri jolly, ad esempio: * e ?.

Se l'oggetto itemspec specifica un percorso del server, il percorso deve essere completo. Ad esempio, non è possibile estrarre tutti gli elementi dei livelli sottostanti alla cartella $/progetti utilizzando ./* come elemento itemspec.

Versionspec

Un oggetto versionspec specifica la versione di un elemento da utilizzare. È possibile specificare le versioni in un comando inserendo l'oggetto versionspec come parte dell'opzione di versione (ad esempio, /version:C1256) o aggiungendo l'oggetto versionspec a un nome di file con un punto e virgola (ad esempio, filename;Lmylabel).

Utilizzare uno qualsiasi dei seguenti modelli per specificare una versione.

Versionspec

Oggetto di descrizione

Insieme di modifiche

Versione che appartiene al numero di insieme di modifiche changeset. Esempio: C1256.

Llabel

Versione che appartiene all'etichetta label. Esempio: Lmylabel.

Daaaa-mm-ggTxx:xx

oppure

Dmm/gg/aaaa

oppure

Qualsiasi formato supportato di .NET Framework.

oppure

Qualsiasi formato di data per il computer locale.

Qualsiasi formato di data e ora che possa essere analizzato da un metodo .NET Framework.

Ad esempio: D2008-01-21T16:00.

Per ulteriori informazioni sui formati di data e ora, vedere Struttura DateTime nella libreria di classi di .NET Framework.

W

La versione più recentemente scaricata nella propria area di lavoro con il comando get.

Wworkspacename;workspaceowner

La versione più recentemente scaricata nell'area di lavoro specificata con il comando get.

Esempio: WResolveRIConflicts;AKerry

T

Versione più recente.

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

Vedere anche

Riferimenti

Opzioni della riga di comando

Concetti

Comandi di carattere informativo

Utilizzo delle aree di sospensione

Utilizzo degli insiemi di modifiche

Altre risorse

Riferimenti alla riga di comando del controllo della versione di Team Foundation

Comandi dell'utilità della riga di comando Tf