Odniesienie do polecenia kontroli wersji programu Team Foundation
Niemal wszystkie zadania, które można wykonać w programie Visual Studio, a także kilka zadań, które nie mogą być wykonane w programie Visual Studio, można użyć polecenia sterowania wersji.Można użyć tf.exe narzędzie, aby uruchomić polecenia sterujące wersją z wiersza polecenia lub w skrypcie.
Co chcesz zrobić?
Uruchomić polecenie
Konfigurowanie komputera odchylenia standardowego
Opracowanie aplikacji
Zawiesić swoją pracę
Program Contribute swoją pracę
Zarządzanie plikami i rozwiązywania problemów
Izolowanie ryzyka
Zrozumieć składnię polecenia
Określanie elementów dotyczy polecenia
Użyj argumentu itemspec, aby określić elementy, których dotyczy problem
Użyć argumentu versionspec, aby określić, którego dotyczy wersji elementów
Opcje służą do modyfikowania jak funkcje polecenia
Użyj opcji /noprompt Aby pominąć żądań dla danych wejściowych i przekierować dane wyjściowe do okna wiersza polecenia
Opcja Napisz umożliwia określanie poświadczeń przy wykonywaniu poleceń
Użyj opcji /lock, aby zastosować lub usunąć blokady
Używanie opcji skrótów
Zrozumieć kody zakończenia
Uruchomić polecenie
Uruchomić wiersza polecenia programu Visual Studio, z systemu Windows Start, wybierz polecenie Microsoft Visual Studio w 2012 r., Visual Studio Tools, a następnie wybierz jedną z polecenia skróty.
W większości przypadków uruchomieniu polecenia kontroli wersji w odniesieniu do katalogu, który jest mapowany w obszarze roboczym.Na przykład $/SiteApp/Main/ jest mapowany na c:\code\SiteApp\Main\.Aby uzyskać najnowszą wersję wszystkich elementów w obszarze roboczym:
c:\code\SiteApp\Main\SolutionA>tf get
[!UWAGA]
Firma Microsoft nie aktualnie ponownie niektóre tematy.Jednak można odczytać wersji programu Visual Studio 2010 z tych tematów.
Konfigurowanie komputera odchylenia standardowego i zarządzanie obszarami roboczymi
Obszar roboczy jest codebase lokalną kopię zespołu.Dlatego, że kopia lokalna na komputerze odchylenia standardowego, mogą tworzyć i testować swój kod w izolacji, aż użytkownik będzie gotowy do zaewidencjonowania swoją pracę.Oto niektóre polecenia do zarządzania obszaru roboczego:
Proxy Command(Program visual Studio 2010)
WorkFold Command(Program visual Studio 2010)
Workspace Command(Program visual Studio 2010)
Workspaces Command(Program visual Studio 2010)
See also: Konfiguracja komputera deweloperskiego i rozpoczęcie korzystania z systemu kontroli wersji,Zarządzaj obszarami roboczymi
Opracowanie aplikacji
Te polecenia służą do projektowania aplikacji w systemie kontroli wersji z zespołem:
Polecenie Add
Dodaje pliki i foldery do kontroli wersji.Wyewidencjonowanie (lub edycja) polecenia
Wyewidencjonuje plik, a następnie zmienia jego stan Oczekujące zmiany "Edit".Usuwanie polecenia (kontroli wersji Team Foundation)(Program visual Studio 2010)
Polecenie Get
Pobiera (Pobieranie) najnowsze lub określonej wersji plików lub folderów z programu Team Foundation Server do obszaru roboczego.Zmienianie nazwy polecenia (kontroli wersji Team Foundation)(Program visual Studio 2010)
Polecenie Status
Wyświetla informacje o oczekujące zmiany do plików i folderów elementów w jednym lub wielu obszarów roboczych lub w shelveset.Polecenie Undo
Usuwa jeden lub więcej oczekujących zmian do plików lub folderów.Undelete Command(Program visual Studio 2010)
Zobacz też:Opracowanie aplikacji użytkownika w Codebase kontrolą wersji
Zawiesić swoją pracę
Różnych powodów czasami trzeba do odłogowania w niektórych lub wszystkich wykonywanych prac.Aby wstrzymać i wznowić pracę i zarządzać swoimi shelvesets, należy użyć tych poleceń:
Polecenie shelve(Program visual Studio 2010)
Shelvesets Command(Program visual Studio 2010)
Polecenie unshelve(Program visual Studio 2010)
See also: Zawieszenia pracy i zarządzanie nimi na Shelvesets.
Program Contribute swoją pracę
Oto jak sprawdzić w kodzie do zespołu codebase:
- Polecenie Checkin
Kontrole w do czasu zmiany plików lub folderów na serwerze.
Zobacz też:Ewidencjonowanie pracy w ścieżce bazowej kodu zespołu
Zarządzanie plikami i rozwiązywania problemów
Umożliwia wyświetlanie i zarządzanie wersja formantu plików i folderów
Polecenie Właściwości(Program visual Studio 2010)
Właściwość polecenia (nie jest udokumentowany)
Dir Command(Program visual Studio 2010)
Destroy Command(Program visual Studio 2010)
LocalVersions Command(Program visual Studio 2010)
Zobacz też:Korzystanie z Eksploratora kontroli źródła do zarządzania plików w systemie kontroli wersji
Przeglądanie i zarządzanie poprzednich wersji
Changeset Command(Program visual Studio 2010)
Polecenie History
Wyświetla historia edycji plików lub folderów.Label Command(Program visual Studio 2010)
Labels Command(Program visual Studio 2010)
Rollback Command(Program visual Studio 2010)
Unlabel Command(Program visual Studio 2010)
View Command(Program visual Studio 2010)
Porównywanie plików i folderów
Difference Command(Program visual Studio 2010)
Folderdiff Command(Program visual Studio 2010)
Rozwiązywanie konfliktów plików
Resolve Command(Program visual Studio 2010)See also: Rozwiązywanie konfliktów plików.
Praca z blokad kontroli wersji
Lock Command(Program visual Studio 2010)See also: Praca z blokadami kontroli wersji.
Izolowanie ryzyka
Aby wyizolować ryzyka za pomocą gałęzi należy użyć następujących poleceń:
Branch Command(Program visual Studio 2010)
Branches Command(Program visual Studio 2010)
Merge Command(Program visual Studio 2010)
Merges Command(Program visual Studio 2010)
See also: Izolowanie ryzyka przy użyciu oddziałów.
Administrować kontroli wersji
Do administrowania systemu kontroli wersji, należy użyć następujących poleceń:
Configure Command(Program visual Studio 2010)
Permission Command(Program visual Studio 2010)
Zobacz też: Administrowanie Team Foundation kontroli wersji (Visual Studio 2010).
Uzyskiwanie pomocy na temat poleceń sterowania wersji
Aby uzyskać więcej informacji na temat poleceń sterowania wersji należy użyć następujących poleceń:
Help Command(Program visual Studio 2010)
Msdn Command(Program visual Studio 2010)
Zrozumieć składnię polecenia
Składnia każdego polecenia pojawia się u góry każdego tematu odniesienia.
Wymaganych i opcjonalnych argumentów
Non nawiasach argumenty są wymagane.**[Brackets]**wskazać argumentów opcjonalnych, które nie są wymagane do wykonania polecenia.Jednak niektóre opcjonalne argumenty mają wartości domyślne, które są stosowane do polecenia, nawet jeśli nie określisz opcję.
Argumenty wyłączności
Kiedy opcje są oddzielone (potoku**|**), można określić jedną z opcji.
Argumenty dosłownie i wymienne
Elementy pogrubione są opcje, które zawierają w dosłownym.Kursywą elementy są argumenty, że należy zamienić na rzeczywiste znaki wykonanie polecenia.
Polecenie skróty i aliasy
Niektóre polecenia obsługują skróty.Na przykład, można wywołać polecenie Delete albo tf delete lub tf del.
Przykład
Na przykład polecenia realizacji transakcji:
tf checkout [/lock:( none|checkin|checkout)] [/recursive] itemspec [/login: username,[ password]]
Podsumujmy argumenty wysuwane w tym przykładzie:
itemspec: należy zastąpić ten argument z itemspec , który określa elementy jest wyewidencjonowywany.
/lock:(none|checkin|checkout): Nie jest wymagane do określenia /lock opcji.Jeśli nie zostanie określony, a następnie system domyślnie określa /lock:none.W przeciwnym razie można określić jedną z opcji Zablokuj.
Następujące argumenty są opcjonalne i jeżeli nie przekazał ich, żaden z ich skutki stosuje się do polecenia:
/recursive: Jeśli chcesz rekursywnie Sprawdź wielu elementów w folderze, należy określić tę opcję, słowo po słowie.
/login:Nazwa użytkownika, hasło: Jeśli chcesz uruchomić polecenie jako inny użytkownik, należy określić /login opcja dosłownie, Zamień Nazwa użytkownika z nazwą użytkownika, i w razie potrzeby można podać hasło.
Określanie elementów dotyczy polecenia
Aby określić elementy, które jest narażony na polecenia, można użyć itemspecs i versionspecs.
Użyj argumentu itemspec, aby określić elementy, których dotyczy problem
Możesz użyć itemspec (Specyfikacja zapasu), aby określić elementy, dotyczy polecenia.Można określić elementy, na komputerze klienckim lub na użytkownika Team Foundation Server.Można użyć znaków wieloznacznych, takich jak * i ?.
Argumenty itemspec klienta
Argument itemspec klient określa ścieżkę do elementów takich jak folder na komputerze klienckim (na przykład, c:\code\SiteApp\Main\SolutionA\) pliku (na przykład, c:\code\SiteApp\Main\SolutionA\Project1\program.cs lub wielu plików (na przykład, c:\code\SiteApp\Main\SolutionA\*.cs.Można również określić ścieżki UNC takich jak \\myshare\code\SiteApp\Main.
Argumenty itemspec serwera
Server itemspec argument określa ścieżkę do elementów na Team Foundation Server, takich jak folder (na przykład, $/SiteApp/Main/SolutionA) pliku (na przykład, $/SiteApp/Main/SolutionA/Project1/program.cs lub wielu plików (na przykład, $/SiteApp/Main/SolutionA/*.cs.
Argumenty itemspec serwer jest zazwyczaj używana, gdy trzeba uruchomić polecenie na zapasy nie na ich komputerach.Na przykład pracujesz na komputerze odchylenia standardowego i potrzebujesz, aby niektóre dane na temat poprawek historii o pewnych elementów, które należą do zespołu zbioru projektu, które nie działają prawidłowo w:
c:\>tf history /collection:http://fabrikam-3:8080/tfs/DefaultCollection
$/SiteApp/Main/SolutionA/Project1/* /recursive
/noprompt
Wiele argumentów itemspec
Dla niektórych poleceń, można określić wiele itemspec argumentów.Na przykład:
c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c
Wyewidencjonuje plik program.cs i program2.c.
Użyć argumentu versionspec, aby określić, którego dotyczy wersji elementów
Możesz użyć versionspec (wersja specification) do określenia wersji elementów dotyczy polecenia.Zapewnienie versionspec można:
Użycie /version opcji.Na przykład: /version:C44.
Dołącz versionspec do itemspec średnikiem.Na przykład: program1.cs;C44.
Podczas korzystania z Polecenie History lub Difference Command, można określić zakres wersji, oddzielając w wersjach z tyldy (~).Na przykład:
c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012
Należy użyć następującej składni, aby określić versionspec.
Typ |
Składnia |
Opis |
---|---|---|
Zestawu zmian |
[C]n |
Określa elementy na podstawie numeru zestawu zmian.Jeśli element, który znajduje się w zakresie nie zostały zmodyfikowane podczas określonego zestawu zmian, system ma najnowszą wersję elementu, który miał miejsce przed określonego zestawu zmian.
Porada
Można pominąć C Jeśli podaje się tylko numer.
Przykłady
- lub -
- lub -
Jeśli plik readme.txt został zmodyfikowany w zestawu zmian 8, pobiera tej wersji pliku.W przeciwnym razie pobiera najbardziej aktualną wersję readme.txt przed jej zastosowaniem 8. |
Etykieta |
Llabel |
Określa elementy, do której label został zastosowany. Przykłady
Pobiera wersję readme.txt, który był oznaczony JulyHotFix.
Pobiera wersję wszystkich elementów z etykietą (i usunie te elementy nie oznaczone) w obszarze roboczym znajdowały się kiedy zestawu zmian oznaczone jako LastKnownGood został utworzony, na przykład, być może, w ramach zautomatyzowany proces kompilacji. |
Data i godzina |
Dyyyy-mm-ddTxx:xx –lub– Dmm/dd/yyyy –lub– Dowolny format obsługiwanych.NET Framework. –lub– Dowolny format daty, obsługiwane na komputerze lokalnym. |
Określa zestawu zmian, utworzony na określonej dacie i godzinie. Przykłady
Aktualizacje obszaru roboczego, aby dopasować kodu jako istniała na 3/22/2004 00: 00 (północ).
Aktualizacje obszaru roboczego, aby dopasować kodu jako istniała na 3/22/2004 09: 00 (9: 00). Aby uzyskać więcej informacji na temat obsługiwanych.NET Framework Data i godzina Zobacz formaty DateTime i Standardowy format daty i ciągi formatu czasu. |
Obszar roboczy (bieżący) |
W |
Określa numer wersji w obszarze roboczym. |
Obszar roboczy (określony) |
Wworkspacename; workspaceowner |
Określa numer wersji w określonym obszarze roboczym. Na przykład: WResolveRIConflicts;PeterW |
Porada |
T |
Określa wersję. |
Opcje służą do modyfikowania jak funkcje polecenia
Kilka typowych opcji służy do modyfikowania jak funkcje polecenia.
Użyj opcji /noprompt Aby pominąć żądań dla danych wejściowych i przekierować dane wyjściowe do okna wiersza polecenia
Użycie /noprompt możliwość powstrzymania wnioski o dane wejściowe i przekierować dane wyjściowe do okna wiersza polecenia.Ta opcja może być przydatna, gdy trzeba użyć polecenia sterowania wersji w skrypcie, ponieważ polecenie będzie kontynuował bez interwencji użytkownika, a dane są dostępne dla skryptu, aby wykonywać operacje takie jak podczas analizowania lub aby przechwycić.
Użycie tej opcji system:
Pomija wszystkie żądania dotyczące wprowadzania:
W oknie wiersza polecenia nie zadanych pytań.Na przykład, użycie Polecenie Undo po wybraniu tej opcji system nie monituje o potwierdzenie, czy chcesz kontynuować cofanie zmian.
Okna i okna dialogowe nie są prezentowane.Na przykład użyć tej opcji, z Polecenie Checkin.Zamiast wyświetlać Zaewidencjonuj okno dialogowe umożliwiające potwierdzenie opcje (elementy, które chcesz zaewidencjonować lub której elementy, aby skojarzyć pracy), system wpływy z zaewidencjonowania bez potwierdzenia.
Przekierowuje dane wyjściowe dane do wiersza polecenia.Na przykład użyć tej opcji, z Polecenie History.Dane są wyświetlane w oknie wiersza polecenia, a nie okno historii.
Opcja Napisz umożliwia określanie poświadczeń przy wykonywaniu poleceń
Użycie /login opcję, aby określić konto użytkownika Team Foundation Server, aby uruchomić polecenie.Ta opcja może być przydatne, gdy pracujesz na komputerze innego członka zespołu.
Na przykład Julia współpracuje z Peter na jego maszynie odchylenia standardowego.Dzięki pakietowi polecenia Lock do odblokowania pliku, który ona wcześniej zablokowany:
c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI,JuliaPassword
Jeśli chce uniknąć konieczności jej hasła są wyświetlane w wierszu polecenia, może ona wejść polecenia bez hasła:
c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI
Ona wejścia tego polecenia, a następnie monituje ją do jej hasło należy wpisać w oknie dialogowym, że maski wprowadzania jej.
Użyj opcji /lock, aby zastosować lub usunąć blokady
Ważne |
---|
Najlepszym rozwiązaniem, użyj /lock opcję na własne ryzyko i powiadamiać informował, dlaczego jesteś zamek i element, a kiedy masz zamiar usunąć blokady. |
Użycie /lock opcję, aby zastosować lub usunąć blokady w tym samym czasie, takich jak wykonać inne polecenie Dodaj lub edytować.
/lock:(none|checkin|checkout)
None: Blokada nie znajduje się na elemencie.Jeśli blokada jest już w miejscu, jest ona usuwana.
Checkinlub Checkout: zastosowanie blokady.Zobacz Zrozumienie typów Lock.
[!UWAGA]
W niektórych przypadkach operacji blokowania może się nie powieść:
Jeśli żaden inny użytkownik zamknął określonego elementu, operacji blokowania nie powiedzie się.
System zignoruje ten przełącznik, jeśli istnieje już oczekująca zmiana do elementu.W takim przypadku należy użyć Lock Command Aby zmienić blokadę na przedmiot.
Używanie opcji skrótów
Można skrócić do następujących opcji.
Opcja |
Opcja aliasu |
---|---|
/comment |
-C |
/computer |
-M |
/delete |
-D |
/force |
-P |
/format |
-F |
/help |
-?, -H |
/lock |
-K |
/login |
-Y |
/newname |
-N |
/noprompt |
-I |
/owner |
-O |
/recursive |
-R |
/server |
-S |
/slotmode |
-X |
/template |
-T |
/user |
-U |
/version |
-V |
/workspace |
-W |
Zrozumieć kody zakończenia
Polecenia sterujące wersją zwraca poniższe kody zakończenia:
Kod wyjścia |
Definicja |
---|---|
0 |
Sukces. |
1 |
Częściowy sukces; co najmniej oznacza, że coś, lub ewentualnie wszystko, nie powiodło się powiodła się. |
2 |
Nierozpoznane polecenie. |
100 |
Nic nie powiodło się. |
Na przykład:
c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c
Jeśli jeden z tych plików, które chcesz sprawdzić nie istnieje na serwerze, polecenie zwraca 1 do wskazania sukcesu częściowe.