Sintassi della riga di comando (Team System)
Aggiornamento: novembre 2007
La sintassi per l'utilità della riga di comando tf.exe.
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 obbligatori per l'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 sottocartelle. Quindi, anche se il parametro itemspec è obbligatorio, non deve essere necessariamente digitato.
Quando due opzioni separate dal carattere pipe (|) sono racchiuse tra parentesi quadrate, è possibile specificare una delle opzioni ma non entrambe. Ad esempio, tf Changeset [/comment:commento|@filecommento] indica che è possibile digitare un commento per un insieme di modifiche dopo l'opzione /comment: oppure (|) che è possibile utilizzare la sintassi **@**filecommento per specificare il percorso di un file che contiene il commento desiderato. 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. Ad 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 “@”, l'opzione del file di comando, per eseguire simultaneamente un insieme di comandi di 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 sul tali 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, un'abbreviazione per la specifica dell'elemento, è un insieme di uno o più i caratteri che Team Foundation risolve come un elemento o un insieme di elementi che fanno riferimento ai percorsi UNC o del file system mappati a un'area di lavoro o al server del controllo della versione.
Per tutti i comandi di Team Foundation che accettano un oggetto itemspec, è possibile specificare percorsi di file locali, ad esempio c:\progetti, percorsi UNC come \\condivisione\progetti o 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.
.gif "Nota") Nota: |
|---|
I comandi di 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 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 o più dei seguenti modelli per specificare una versione.
Versionspec |
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 da .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 |
Versione recuperata per ultima nell'area di lavoro con il comando get. |
T |
Revisione più recente. |
Quando si utilizzano i comandi History, Difference o Merge è possibile specificare un intervallo di versioni separando le versioni tra loro mediante un carattere tilde (~). Vedere gli esempi seguenti per specificare un intervallo separando le versioni con una tilde:
Per visualizzare solo la cronologia del file Form1.cs per l'insieme di modifiche 137.
Esempio di sintassi: **tf history /version:**C137~C137
Per ottenere la differenza tra gli insiemi di modifiche C123 e C125 per il file form.cs.
Esempio di sintassi: tf difference/versionC123~C125 form1.cs.
Per unire tutte le versioni dal primo insieme di modifiche fino all'insieme di modifiche C125 in branch2.
Esempio di sintassi: **tf merge/version:**C125 branch1 branch2.
Vedere anche
Concetti
Comandi di carattere informativo
Utilizzo delle aree di sospensione per il controllo della versione
Utilizzo degli insiemi di modifiche per il controllo della versione
Riferimenti
Altre risorse
Riferimenti alla riga di comando del controllo della versione di Team Foundation