Udostępnij za pośrednictwem

Odniesienie do polecenia kontroli wersji programu Team Foundation

  • Artykuł

Polecenia kontroli wersji umożliwiają są prawie wszystkie zadania, które można wykonać w programie Visual Studio, a także kilka zadań, których nie można wykonać w programie Visual Studio.Można użyć tf.exe narzędzie do uruchamiania polecenia kontroli wersji w wierszu polecenia lub skryptu.

Co chcesz zrobić?

  • Uruchom polecenie

    • Skonfiguruj komputerze deweloperskim

    • Opracowywanie własnej aplikacji

    • Wstrzymywanie pracy

    • Dołącz zadaniami

    • Zarządzać plikami i rozwiązywania problemów

    • Izolowanie ryzyko

  • Składnia polecenia zrozumieć

  • Określ elementy, których to dotyczy, za pomocą polecenia

    • Użyj argumentu itemspec, aby określić elementy, których to dotyczy

    • Użyj jako argumentu versionspec w celu określenia wersji narażone elementy

  • Użyj opcji, aby zmodyfikować sposób funkcje polecenia

    • Użyj opcji /noprompt, aby pominąć żądania dla danych wejściowych i przekierować dane wyjściowe do okna wiersza polecenia

    • Użyj opcji /login do określania poświadczeń podczas uruchamiania polecenia

    • Użyj opcji /lock, aby zastosować lub usunąć blokady

    • Użyj opcji skrótów

  • Zrozumienie kody zakończenia

Uruchom polecenie

Można uruchomić wiersz polecenia programu Visual Studio, z systemu Windows Start, wybierz polecenie programu Microsoft Visual Studio 2012, programu Visual Studio Tools, a następnie wybierz jedną z wiersza polecenia skrótów.

W większości przypadków możesz uruchomić polecenie kontroli wersji w kontekście katalogu, w którym jest mapowany w obszarze roboczym.Na przykład $/SiteApp/Main/ jest zamapowana na c:\code\SiteApp\Main\.Aby pobrać najnowszą wersję wszystkich elementów w obszarze roboczym:

c:\code\SiteApp\Main\SolutionA>tf get

[!UWAGA]

Firma Microsoft nie aktualnie publikowany ponownie niektóre tematy.Można jednak odczytać wersji programu Visual Studio 2010 z tych tematów.

Konfigurowanie komputerze deweloperskim i zarządzanie obszarami roboczymi

Swój obszar roboczy jest lokalną kopię Twojego zespołu użytkownika bazy kodu.Ponieważ jest ona kopii lokalnej na komputerze deweloperskim, mogą tworzyć i testować kodu w izolacji, dopóki nie będzie gotowe do ewidencjonowania pracę.Oto niektóre polecenia do zarządzania swój obszar roboczy:

Zobacz też: Konfiguracja systemu kontroli wersji programu Team Foundation na komputerze deweloperskim,Tworzenie i praca z obszarami roboczymi

Opracowywanie własnej aplikacji

Do tworzenia aplikacji w kontroli wersji członkom zespołu, należy użyć następujących poleceń:

Zobacz też:Stwórz swoją aplikację w bazie kodu z kontrolą wersji

Wstrzymywanie pracy

Dla różnych możliwych przyczyn czasem trzeba zarezerwowane niektórych lub wszystkich swoją pracę w toku.Wstrzymywanie i wznawianie pracy oraz zarządzanie swoją shelvesets, użyj następujących poleceń:

Zobacz też: Wstrzymanie pracy i zarządzanie zmianami odłożonymi na półkę.

Dołącz zadaniami

Poniżej przedstawiono sposób Sprawdź swój kod do zespołu użytkownika bazy kodu:

  • Polecenie Checkin
    Sprawdza w oczekujących zmian w plikach i folderach na serwerze.

Zobacz też:Ewidencjonowanie pracy w ścieżce bazowej kodu zespołu

Zarządzać plikami i rozwiązywania problemów

Izolowanie ryzyko

Za pomocą następujących poleceń wykrywać ryzyka przy użyciu gałęzie:

Zobacz też: Używaj odgałęzień, aby izolować ryzyko w kontroli wersji Team Foundation.

Administrowanie kontroli wersji

Aby zarządzać systemie kontroli wersji, należy użyć następujących poleceń:

Zobacz też: Administrowanie Team Foundation kontroli wersji (Visual Studio 2010).

Uzyskaj pomoc dotyczącą poleceń kontroli wersji

Aby uzyskać więcej informacji na temat polecenia kontroli wersji, należy użyć następujących poleceń:

Składnia polecenia zrozumieć

Składnia polecenia każdego pojawi się u góry każdego tematu odwołania.

Argumenty wymagane i opcjonalne

Argumenty oddzielona nie są wymagane.**[Brackets]**wskaż argumentów opcjonalnych, które nie są wymagane do wykonania polecenia.Niektóre opcjonalnych argumenty jednak ustawienia domyślne, które są stosowane do polecenia, nawet jeśli nie określono opcji.

Argumenty wyłączności

Jeśli opcje są oddzielone (potoku)|), można określić jedną z opcji.

Argumenty Verbatim i replaceable

Opcje dosłownie zawierających są pogrubione elementy.Pisany kursywą argumentów, należy zastąpić rzeczywiste znaki, które można wykonać polecenia są elementy.

Polecenie skróty i aliasy

Niektóre polecenia obsługują skróty.Na przykład można wywołać metodę usunąć polecenia z jednej tf delete lub tf del.

Przykład

Na przykład polecenie Checkout:

tf checkout [/lock:( none|checkin|checkout)] [/recursive] itemspec [/login: username,[ password]]

Przejrzyj Przyjrzyjmy argumenty w tym przykładzie:

  • itemspec: należy zastąpić tego argumentu z itemspec określający elementy wyewidencjonowywany.

  • /lock:(none|checkin|checkout): Nie należy określać /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 blokady.

  • Następujące argumenty są opcjonalne i jeśli nie zostanie podana, ich, żaden z ich skutki dotyczą polecenia:

    • /recursive: Jeśli chcesz rekursywnie wyewidencjonowania wiele elementów w folderze, należy określić tę opcję verbatim.

    • /login:nazwy użytkownika, hasło: Jeśli chcesz uruchomić polecenie jako inny użytkownik, należy określić /login opcji dosłownie, Zastąp nazwy użytkownika z nazwą użytkownika, i w razie potrzeby można podać hasło.

Określ elementy, których to dotyczy, za pomocą polecenia

Itemspecs i versionspecs służy do określania, elementy, które ma wpływ polecenia.

Użyj argumentu itemspec, aby określić elementy, których to dotyczy

Możesz użyć itemspec (określenie elementu) do określania elementów, których to dotyczy, za pomocą polecenia.Możesz określić elementy na komputerze klienckim lub programu Team Foundation Server.Można użyć symboli wieloznacznych, takich jak * i ?.

Argumenty itemspec klienta

Argumentem itemspec klienta Określa ścieżkę do elementów na komputerze klienckim, takich jak folder (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

Argument itemspec server Określa ścieżkę do elementów na Twój 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 server jest zazwyczaj używana, gdy należy uruchomić polecenie w elementach nie na komputerze klienckim.Na przykład pracujesz na komputerze deweloperskim i, aby zdobyć określone dane Historia poprawek o kilka elementów, które znajdują się w kolekcji projektów zespołowych, które nie działają w:

c:\>tf history /collection:http://fabrikam-3:8080/tfs/DefaultCollection
$/SiteApp/Main/SolutionA/Project1/* /recursive  
/noprompt

Używanie wielu 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

Sprawdza, czy plik program.cs i program2.c.

Użyj jako argumentu versionspec w celu określenia wersji narażone elementy

Możesz użyć versionspec (wersja specyfikacji) do określenia wersji elementów, których to dotyczy, za pomocą polecenia.Aby zapewnić versionspec można:

  • Używając opcji /version.Na przykład: /version:C44.

  • Dołącz versionspec do itemspec średnikiem.Na przykład: program1.cs;C44.

Przy użyciu Polecenie History lub Difference Command, można określić zakres wersji, oddzielając wersje od tyldy (~).Na przykład:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012

Użyj następującej składni, aby określić versionspec.

Typ

Składnia

Opis

Zestaw zmian

[C]n

Określa elementy w oparciu o liczbę grupę zmian.Jeśli element znajduje się w zakresie nie został zmodyfikowany w określonym grupę zmian, system ma najnowszą wersję elementu, który wystąpił przed określoną grupę zmian.

PoradaPorada

Można pominąć C Jeśli określono tylko liczbę.

Przykłady

c:\code\SiteApp\Main>tf get readme.txt /v:C8

--lub--

c:\code\SiteApp\Main>tf get readme.txt /v:8

--lub--

c:\code\SiteApp\Main>tf get readme.txt;8

Jeśli readme.txt został zmodyfikowany w changeset 8, pobiera wersję tego pliku.W przeciwnym razie pobiera najbardziej aktualne wersje readme.txt przed wersji 8.

Etykieta

Llabel

Określa elementy, do którego label została zastosowana.

Przykłady

c:\code\SiteApp\Main>tf get readme.txt;LJulyHotFix

Pobiera wersję readme.txt, który został oznaczony JulyHotFix.

c:\code\SiteApp\Main>tf get /version:LLastKnownGood

Pobiera wersję wszystkich elementów z etykietą (i usunie te elementy nie oznaczony) w obszarze roboczym znajdowały się one po elemencie changeset oznaczone jako LastKnownGood została utworzona, na przykład, być może w ramach automatyczne proces kompilacji.

Data i godzina

Dyyyy-mm-ddTxx:xx

—lub—

Dmm/dd/yyyy

—lub—

Format wszystkie obsługiwane platformy .NET Framework.

—lub—

Dowolne z formatów daty obsługiwane na komputerze lokalnym.

Określa grupę zmian utworzony na określoną datę i godzinę.

Przykłady

c:\code\SiteApp\Main>tf get /version:D2004-03-22

Aktualizuje obszar roboczy, aby dopasować bazy kodu, ponieważ miała na 3/22/2004 00:00 (północ).

c:\code\SiteApp\Main>tf get /version:D2004-03-22T09:00

Aktualizuje obszar roboczy, aby dopasować bazy kodu, jak miała na 3/22/2004 09:00 (9 AM).

Aby uzyskać więcej informacji o obsługiwanych .NET Framework Data i godzina Zobacz formaty DateTime i Standardowe ciągi formatujące datę i godzinę.

(Bieżący) obszar roboczy

W

Określa wersję w obszarze roboczym.

Obszar roboczy (określono)

Wworkspacename; workspaceowner

Określa wersję w określonym obszarze roboczym.

Na przykład: WResolveRIConflicts;PeterW

Porada

T

Określa najnowszej wersji.

Użyj opcji, aby zmodyfikować sposób funkcje polecenia

Kilka typowych opcji służy do modyfikowania jak funkcje polecenia.

Użyj opcji /noprompt, aby pominąć żądania dla danych wejściowych i przekierować dane wyjściowe do okna wiersza polecenia

Użyj /noprompt opcję, aby pominąć żądań dla danych wejściowych i przekierować dane wyjściowe do okna wiersza polecenia.Ta opcja może być użyteczne w przypadku należy użyć polecenia kontroli wersji w skrypcie, ponieważ polecenie będzie kontynuował bez interwencji przez użytkownika, a dane są dostępne dla skryptu do wykonywania operacji, takich jak analiza lub przechwytywanie.

Używając tej opcji systemu:

  • Pomija wszystkie żądania dla danych wejściowych:

    • W oknie wiersza polecenia nie zadanych pytań.Na przykład, używając Polecenie Undo po wybraniu tej opcji system nie wyświetla monitu o potwierdzenie, czy chcesz kontynuować cofanie zmian.

    • Pola systemu Windows i okna dialogowego nie są prezentowane.Na przykład wybranie tej opcji z Polecenie Checkin.Zamiast Zaewidencjonuj okno dialogowe dla o potwierdzenie opcje (elementy, które chcesz sprawdzić lub którego elementy do skojarzenia pracy), system kontynuowanie ewidencjonowania bez potwierdzenia.

  • Przekierowuje dane wyjściowe danych do wiersza polecenia.Na przykład wybranie tej opcji z Polecenie History.Dane są wyświetlane w oknie wiersza polecenia, a nie okno historii.

Użyj opcji /login do określania poświadczeń podczas uruchamiania polecenia

Użyj /login opcję, aby określić konto użytkownika programu Team Foundation Server, aby uruchomić polecenie.Ta opcja może być przydatna podczas pracy na komputerze innego członka zespołu.

Na przykład Julia jest pracować Peter na jego komputerze deweloperskim.Używa blokowania polecenie do odblokowania go wcześniej zablokowany plik:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI,JuliaPassword

Jeśli chce uniknąć zastępowania swoje hasło, które są widoczne w wierszu polecenia, użytkownik wprowadź polecenie bez hasła:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI

Gdy użytkownik wprowadzi to polecenie, następnie monituje jej do wpisz swoje hasło w oknie dialogowym maski swoje dane wejściowe.

Użyj opcji /lock, aby zastosować lub usunąć blokady

Ważna uwagaWażne

Najlepszym rozwiązaniem, użyj /lock opcji na własne ryzyko i powiadom o problemie pracę współpracownikom, dlaczego są blokowania elementu i zamierzasz usunąć blokady.

Użyj /lock opcję, aby zastosować lub usunąć blokady w tym samym czasie, takich jak uruchomić polecenie innego Dodaj lub edytować.

/lock:(none|checkin|checkout)

  • None: Zablokuj nie jest umieszczany w elemencie.Blokada jest już w miejscu, zostanie ono usunięte.

  • Checkinlub Checkout: stosuje blokady.Zobacz Informacje o typach blokady.

[!UWAGA]

W niektórych przypadkach operacja blokowania może zakończyć się niepowodzeniem:

  • Innych użytkowników zablokować żadnego z elementów określonych, operacja blokowania zakończy się niepowodzeniem.

  • System zignoruje tego przełącznika, jeśli istnieje już oczekujące zmiany do elementu.W takim przypadku należy użyć Lock Command można zmienić blokady w elemencie.

Użyj opcji skrótów

Można skrócić następujące opcje.

Opcja

Alias opcji

/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

Zrozumienie kody zakończenia

Polecenia kontroli wersji zwracają poniższe kody zakończenia:

Kod zakończenia

Definicja

0

Powodzenie.

1

Częściowe Powodzenie; oznacza to, co najmniej coś lub prawdopodobnie wszystko, nie powiodło się powiedzie 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 próbujesz wyewidencjonować nie istnieje na serwerze, zwraca polecenie 1 do wskazania częściowe Powodzenie.