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.
.gif "Suggerimento") Suggerimento |
|---|
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
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