Zasady składni wiersza polecenia (Team Explorer Everywhere)
Teraz jest zainstalowany Obsługujący wiele platform klient wiersza polecenia programu Team Foundation Server.Jednak przed wpisaniem jakiegokolwiek polecenia trzeba zrozumieć ogólne informacje o składni i użyciu.
W tym temacie
Opcje określania
Na komputerach z systemem UNIX ścieżki bezwzględne rozpoczynają się kreską ułamkową (/), dzięki czemu na początku opcji można wstawiać łącznik (-).W przeciwnym razie Obsługujący wiele platform klient wiersza polecenia programu Team Foundation Server nie może odróżnić ścieżki od opcji.
Cytowanie i wychodzenie
Powłoki systemu UNIX obsługują wiele znaków specjalnych symboli wieloznacznych, wyrażeń regularnych itd.Jeśli argumenty te zawierają znaki uważane przez powłokę za specjalne, trzeba dodawać znaki ucieczki lub umieszczać argumenty poleceń w cudzysłowach.Można oznaczyć tekst literału w powłokach Unix, jak pokazano poniżej:
Aby zachować wartość literału znaku, należy ją poprzedzić znakiem kreski ułamkowej odwróconej (\).Na przykład:
tf checkout -recursive $/Inventory/Client\ Suite/
Aby zachować wartości literału znaków ujętych w nawias, należy ująć tekst w apostrofy (‘’).Zmienne interpretery komend oznaczone symbolem dolara ($) i symbole wieloznaczne nie są rozwinięte, jeśli są one ujęte w pojedynczy cudzysłów.Na przykład:
tf checkout -recursive ‘$/Inventory/Client Suite/’
Aby zachować wartości literału znaków ujętych w nawias (z wyjątkiem $, `, \ i !), należy ująć tekst w cudzysłów (“”).
Z powodu tych wyjątków zmienne są rozwinięte, powłoki podrzędne nadal są oceniane, ukośnik odwrotny nadal może służyć jako znacznik ucieczki, a zdarzenia historii są nadal rozwijane.Poniższy przykład pokazuje, że znaku odwrotnej kreski ukośnej jest nadal wymagana w celu przeciwdziałania! od rozbudowywana do zdarzenia historii.
tf checkin -comment:”Fixed the bug\!” file.java
Ścieżki serwera dla Visual Studio Team Foundation Server rozpoczyna znak dolara, ale powłoki systemu Unix używają znaku dolara do uruchamiania rozszerzeń zmiennej.Komendy, takie jak: sh, ksh, bash oraz zsh rozpoznają, że znak w ścieżce serwera pojawiający się za symbolem dolara nie jest prawidłową nazwą zmiennej.Dlatego te powłoki przekazują niezmieniony znak dolara do Obsługujący wiele platform klient wiersza polecenia programu Team Foundation Server.
Jednak powłoki będące pochodnymi powłoki csh (włączając tcsh) nie analizują wiersza polecenia w ten sposób.Powłoki te odczytują znak dolara i próbują podstawić zmienną, która pasuje do tekstu, który następuje po tym znaku.Ponieważ tekst następujący dalej jest ukośnikiem (/), a te powłoki wymagają, aby nazwy zmiennych zaczynały się literami, pojawia się błąd.Jeśli używasz powłoki csh lub tcsh, musisz zastosować ucieczkę przy znakach dolara w ścieżkach serwera za pomocą ukośnika odwrotnego lub znaków pojedynczego cudzysłowu.Cudzysłów podwójny powoduje, że powłoka próbuje rozwinąć zmienną.Oto kilka przykładów ucieczek i cytowania dla powłoki csh:
tf checkout -recursive \$/Inventory/Client\ Suite/
tf checkout -recursive ‘$/Inventory/Client Suite/’
tf checkout -recursive \$”/Inventory/Client Suite/”
Specyfikacje elementów
Specyfikacja elementu jest ścieżką lokalną lub na serwerze, która opisuje plik lub folder, który jest parametrem wejściowym dla opcji lub polecenia narzędzia Obsługujący wiele platform klient wiersza polecenia programu Team Foundation Server.Specyfikacja elementu może zawierać sufiks specyfikacji wersji, oddzielony średnikiem.Ten sufiks jest opcjonalny.Określ sufiks tylko wtedy, gdy chcesz się odnieść do starej wersji elementu.
Przykład specyfikacji elementu:
Specyfikacja elementu |
Opis |
---|---|
$/Inventory/src |
Ścieżka serwera do folderu |
$/Inventory/src/Class.Java |
Ścieżka serwera do pliku |
/tmp/Inventory |
Ścieżka lokalna (w systemie Unix) do folderu roboczego |
/tmp/Inventory/src/Class.java |
Ścieżka lokalna (w systemie Unix) do pliku |
C:\Inventory\src |
Ścieżka lokalna (w systemie Windows) do folderu roboczego |
C:\Inventory\src\Class.java |
Ścieżka lokalna (w systemie Windows) do pliku |
$/Inventory/src;C4095 |
Ścieżka serwera do folderu dla zestawu zmian 4095 |
.\Class.Java;C129 |
Względna ścieżka lokalna (Windows) do pliku na zestawie zmian 129 |
./Class.java;Lrelease-1.0 |
Względna ścieżka lokalna (Unix) do pliku na wydaniu etykiety — 1.0 |
$/Inventory/src/file.txt;Wdev;john |
Ścieżka serwera w wersji w obszarze roboczym dev, którego właścicielem jest John. |
file.txt;D01/01/2007 |
Ścieżka lokalna w dniu 1 stycznia 2007 r.
|
file.txt;X1067 |
Wcześniej usunięty plik o identyfikatorze 1067 |
Specyfikacja wersji
Specyfikacja wersji to specjalnie sformatowany ciąg, który odwołuje się do określonej jednej wersji lub zakresu wersji elementu w systemie kontroli wersji.Wersja specyfikacji są używane na dwa sposoby: jako sufiksy do specyfikacji elementu (zobacz Specyfikacje elementu wcześniej w tym temacie) i jako autonomiczne wartości do -version dla niektórych opcji polecenia.
Przykład specyfikacji wersji:
Format specyfikacji wersji |
Opis |
---|---|
T |
Najnowsza wersja. |
Cn |
Wersja w changeset n. |
LlabelID |
Wersja na etykiecie labelID. |
Wname; owner |
Wersja aktualnie w obszarze roboczym name posiadanych przez owner. |
Ddatestring |
Wersja w Data i godzina określona wdatestring |
XdeletionID |
Wersja, który został usunięty i biorąc pod uwagę deletionID przez serwer. |