Sintassi della riga di comando (Team Explorer Everywhere)
È stato installato Client della riga di comando per più piattaforme per Team Foundation Server.Ma prima di digitare il comando, sarà necessario comprendere la sintassi e le informazioni generali di utilizzo.
In questo argomento
Specifica delle opzioni
Nei computer UNIX, i percorsi assoluti iniziano con una barra (/), quindi utilizzare un trattino (-) per avviare opzioni.In caso contrario, Client della riga di comando per più piattaforme per Team Foundation Server non può stabilire un percorso di un'opzione.
Virgolette e caratteri di escape
Le shell di UNIX supportano molti caratteri speciali come caratteri jolly, espressioni regolari e così via.Se tali argomenti contengono caratteri considerati speciali dalla shell, è necessario utilizzare caratteri di escape o racchiudere gli argomenti tra virgolette per i comandi.È possibile contrassegnare il testo letterale nelle shell di UNIX come illustrato di seguito:
Per mantenere il valore letterale del carattere, anteporre al carattere una barra rovesciata (\).Di seguito è riportato un esempio:
tf checkout -recursive $/Inventory/Client\ Suite/
Per mantenere il valore letterale dei caratteri racchiusi, racchiudere il testo tra virgolette singole ('').Le variabili della shell a cui viene fatto riferimento con un segno di dollaro ($) e caratteri jolly non vengono espanse se sono racchiusi tra virgolette semplici.Di seguito è riportato un esempio:
tf checkout -recursive ‘$/Inventory/Client Suite/’
Per mantenere il valore letterale dei caratteri racchiusi (ad eccezione di $, `, \, e !), racchiudere il testo tra virgolette doppie (" ").
A causa di queste eccezioni, le variabili vengono espanse, le sottoshell vengono ancora valutate, la barra rovesciata può essere comunque utilizzata per inserire i caratteri di escape e gli eventi della cronologia sono ancora espansi.Nell'esempio seguente viene mostrato che serve comunque una barra rovesciata per impedire il carattere !di essere espanso in un evento di cronologia.
tf checkin -comment:”Fixed the bug\!” file.java
I percorsi server per Visual Studio Team Foundation Server iniziano con un segno di dollaro, ma le shell di UNIX utilizzano il simbolo di dollaro per avviare l'espansione di variabili.Le shell come sh, ksh, bash e zsh riconoscono che il carattere in un percorso server che si verifica dopo il simbolo del dollaro non è un nome di variabile valido.Di conseguenza, queste shell passano invariato il simbolo del dollaro al Client della riga di comando per più piattaforme per Team Foundation Server.
Tuttavia, gli shell derivati da csh (incluso tcsh) non analizzano la riga di comando in questo modo.Queste shell leggono il simbolo del dollaro e tentano di sostituire una variabile che corrisponde al testo che segue.Poiché nel testo di seguito è riportata una barra (/) e la shell richiedono che i nomi di variabili inizino con una lettera, viene visualizzato un errore.Se si utilizza la shell tcsh o csh, è necessario utilizzare caratteri di escape per i segni di dollaro nei percorsi server utilizzando una barra rovesciata o virgolette singole.Le virgolette fanno in modo che la shell tenti di espandere la variabile.Di seguito sono riportati alcuni esempi su come utilizzare i caratteri di escape e le virgolette nelle shell di csh:
tf checkout -recursive \$/Inventory/Client\ Suite/
tf checkout -recursive ‘$/Inventory/Client Suite/’
tf checkout -recursive \$”/Inventory/Client Suite/”
Specifiche dell'elemento
Una specifica di elemento è un percorso locale o un percorso server che descrive un file o una cartella che è un parametro di input in un'opzione o un comando per Client della riga di comando per più piattaforme per Team Foundation Server.Una specifica di elemento potrebbe contenere un suffisso di specifica della versione, separato da un punto e virgola.Questo suffisso è facoltativo.Specificare il suffisso solo quando si desidera fare riferimento a una versione cronologica di un elemento.
Specifiche dell'elemento di esempio:
Specifica dell'elemento |
Descrizione |
---|---|
$/Inventory/src |
Percorso server di una cartella |
$/Inventory/src/Class.java |
Percorso server di un file |
/tmp/Inventory |
Percorso locale (Unix) di una cartella di lavoro |
/tmp/Inventory/src/Class.java |
Percorso locale (Unix) di un file |
C:\Inventory\src |
Percorso locale (Windows) di una cartella di lavoro |
C:\Inventory\src\Class.java |
Percorso locale (Windows) di un file |
$/Inventory/src;C4095 |
Percorso server in una cartella nell'insieme di modifiche 4095 |
.\Class.java;C129 |
Percorso locale relativo (Windows) di un file nell'insieme di modifiche 129. |
./Class.java;Lrelease-1.0 |
Percorso locale relativo (Unix) di un file con l'etichetta "versione" 1.0 |
$/Inventory/src/file.txt;Wdev;john |
Percorso server della versione nell'area di lavoro dello sviluppatore di proprietà di John. |
file.txt;D01/01/2007 |
Percorso locale al 1° gennaio 2007
Nota
Sono supportate le date ISO 8601.Le date vengono analizzate in base alle impostazioni locali dell'utente.
|
file.txt;X1067 |
File precedentemente eliminato con deletionID 1067 |
Specifiche versione
Una specifica della versione è una stringa formattata in modo speciale che fa riferimento a una singola versione specifica o un intervallo di versioni di un elemento nel controllo della versione.Le specifiche della versione vengono utilizzate in due modi: come suffissi delle specifiche dell'elemento (tornare a Item Specifications in questo argomento) e come valori indipendenti dell'opzione -version per determinati comandi.
Specifiche della versione di esempio:
Formato di specifica della versione |
Descrizione |
---|---|
T |
Versione più recente. |
Cn |
Versione nell'insieme di modifiche n. |
LlabelID |
Versione nell'etichetta labelID. |
Wname; owner |
Versione attualmente nell'area di lavoro name di proprietà di owner. |
Ddatestring |
Versione alle data e ora specificate in datestring |
XdeletionID |
Versione che è stata eliminata e dotata di deletionID dal server. |