Přehled příkazů – Team Foundation – správa verzí

Téměř všechny úkoly, které lze provádět v aplikaci Visual Studio a také několik úkolů, které nelze provést v aplikaci Visual Studio, můžete použít příkazy pro řízení verze.Můžete použít tf.exe nástroj spustit příkazy pro řízení verze z příkazového řádku nebo skriptu.

Co chcete udělat?

• Spustit příkaz

  • Nastavení počítače dev

  • Při vývoji vaší aplikace

  • Pozastavit práci

  • Přispět svou práci

  • Správa souborů a řešení problémů

  • Izolovat rizika

• Pochopení syntaxe příkazu

• Určit položky, které jsou ovlivněny příkazu

  • Itemspec argument slouží k určení zboží

  • Versionspec argument slouží k určení ohrožených verzích položek

• Pomocí možnosti upravit jak příkaz funkce

  • Potlačí požadavky pro vstup dat a přesměrovat výstup dat do okna příkazového řádku pomocí příkazu /noprompt

  • Možnost Publikace1 slouží k zadání pověření při spuštění příkazu

  • Možnost /lock k použití nebo odebrání zámku

  • Možnost použití klávesových zkratek

• Porozumět ukončovací kódy

Spustit příkaz

Chcete-li spustit příkazový řádek sady Visual Studio, Windows Start, zvolte Microsoft Visual Studio 2012, Nástroje aplikace Visual Studioa pak zvolte jednu z příkazového řádku zkratky.

Ve většině případů spustit příkaz verze ovládacího prvku v rámci adresáře, který je mapován v pracovním prostoru.Například $/SiteApp/Main/ je mapována na c:\code\SiteApp\Main\.Chcete-li získat nejnovější verzi všech položek v pracovním prostoru:

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

[!POZNÁMKA]

Jsme nejsou publikování aktuálně některých témat.Můžete si přečíst verze Visual Studio 2010 z těchto témat.

Nastavit počítač dev a spravovat pracovní prostory

Pracovní prostor je prvku codebase místní kopii vašeho týmu.Protože je místní kopie v počítači dev, můžete vyvíjet a testování kódu v izolaci, dokud nejste připraveni k práci se změnami.Zde jsou některé příkazy pro správu pracovního prostoru:

• Proxy Command(Visual Studio 2010)

• WorkFold Command(Visual Studio 2010)

• Workspace Command(Visual Studio 2010)

• Workspaces Command(Visual Studio 2010)

See also: Instalace vývojářského počítače a první kroky při práci se správou verzí,Správa pracovních prostorů

Při vývoji vaší aplikace

Tyto příkazy použijte k vývoji své aplikace pod kontrolou verze s týmem:

• Příkaz Přidat
  Přidá soubory a složky, Správa verzí.

• Příkaz Rezervovat (nebo Upravit)
  Rezervuje soubor a změní jeho stav čekající změny na "edit".

• Odstranění příkazu (Team Foundation verze řízení)(Visual Studio 2010)

• Příkaz Načíst
  Získá (stahování) nejnovější nebo zadaná verze jednoho nebo více souborů či složek ze sady Team Foundation Server do pracovního prostoru.

• Přejmenování příkazu (Team Foundation verze řízení)(Visual Studio 2010)

• Příkaz Stav
  Zobrazí informace o čekajících změn souborů a složek položek v jedné nebo více pracovních ploch, nebo shelveset.

• Příkaz Vrátit zpět
  Odstraní jeden nebo více čekající změny k souborům nebo složkám.

• Undelete Command(Visual Studio 2010)

Viz také:Rozvíjet své aplikace v Codebase se kontrolované verze

Pozastavit práci

Pro různé důvody někdy budete muset vyňaté z produkce některých nebo všech rozdělané práce.Chcete-li pozastavit a pokračovat v práci a ke správě vašeho shelvesets pomocí následujících příkazů:

• Příkaz shelve(Visual Studio 2010)

• Shelvesets Command(Visual Studio 2010)

• Příkaz unshelve(Visual Studio 2010)

See also: Pozastavit práce a spravovat vaše Shelvesets.

Přispět svou práci

Chcete-li zkontrolovat váš kód týmu prvku codebase:

• Příkaz Vrátit se změnami
  Kontroly v čekající změny souborů nebo složek na serveru.

Viz také:Vrácení práce se změnami do týmového základu kódu

Správa souborů a řešení problémů

• Zobrazení a Správa kontrolních souborů verze a složek

  • Příkaz Vlastnosti(Visual Studio 2010)

  • Příkaz Vlastnosti (není dokumentován)

  • Dir Command(Visual Studio 2010)

  • Destroy Command(Visual Studio 2010)

  • LocalVersions Command(Visual Studio 2010)

  Viz také:Použití Průzkumníka správy zdrojového kódu ke správě souborů s využitím správy verzí

• Zobrazit a spravovat dřívější verze

  • Changeset Command(Visual Studio 2010)

  • Příkaz Historie
    Zobrazí historii revizí jeden nebo více souborů nebo složek.

  • Label Command(Visual Studio 2010)

  • Labels Command(Visual Studio 2010)

  • Rollback Command(Visual Studio 2010)

  • Unlabel Command(Visual Studio 2010)

  • View Command(Visual Studio 2010)

  Viz také:Zobrazení a správa minulé verze

• Porovnat soubory a složky

  • Difference Command(Visual Studio 2010)

  • Folderdiff Command(Visual Studio 2010)

  Viz také:Zobrazení a správa minulé verze

• Vyřešit konflikty souborů
  Resolve Command(Visual Studio 2010)

  See also: Vyřešit konflikty souborů.

• Práce s verzi uzamčení ovládacího prvku
  Lock Command(Visual Studio 2010)

  See also: Práce s zámky řízení verze.

Izolovat rizika

Zjištění rizika pomocí větví, použijte následující příkazy:

• Branch Command(Visual Studio 2010)

• Branches Command(Visual Studio 2010)

• Merge Command(Visual Studio 2010)

• Merges Command(Visual Studio 2010)

See also: Izolovat riziko pomocí poboček.

Správa verzí

Ke správě systému správy verzí, použijte následující příkazy:

• Configure Command(Visual Studio 2010)

• Permission Command(Visual Studio 2010)

Viz také: Správa verzí Team Foundation (Visual Studio 2010).

Získat nápovědu k příkazům verze ovládacího prvku

Chcete-li získat další informace o příkazech verze ovládacího prvku, použijte následující příkazy:

• Help Command(Visual Studio 2010)

• Msdn Command(Visual Studio 2010)

Pochopení syntaxe příkazu

Syntaxe každého příkazu se zobrazí v horní části každého tématu.

Vyžadované a volitelné argumenty

Bracketed bez argumentů je vyžadováno.**[Brackets]**Označení nepovinných argumentů, které nejsou nutné k dokončení příkazu.Některé volitelné argumenty však mají výchozí hodnoty, které jsou použity k příkazu, i v případě, že nezadáte možnost.

Výhradní argumenty

Pokud jsou možnosti odděleny kanálu (|), můžete zadat jednu z možností.

Verbatim a nahraditelné argumenty

Tučné položky jsou možnosti, které zahrnete modifikacemi.Kurzívou položky jsou argumenty, je třeba nahradit skutečné znaky provést příkaz.

Zkratky příkazu a aliasy

Některé příkazy podporují zkratky.Například můžete volat příkaz Delete buď tf delete nebo tf del.

Příklad

Například příkaz rezervaci:

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

Udělejme si argumenty z tohoto příkladu:

• itemspec: je třeba nahradit tento argument s itemspec , který určuje položky jsou rezervace.

• /lock:(none|checkin|checkout): Není nutné zadat /lock možnost.Pokud není zadán, pak systém ve výchozím nastavení určuje /lock:none.V opačném případě se můžete zadat jednu z možností zamknout.

• Následující argumenty jsou volitelné a pokud je nezadáte, jejich účinky neřeší příkazu:

  • /recursive: Pokud si přejete rekurzivně rezervaci více položek ve složce, je nutné zadat toto verbatim.

  • /login:uživatelské jméno, heslo: Pokud chcete spustit příkaz jako jiný uživatel, je třeba zadat /login možnost modifikacemi, nahradit uživatelské jméno se jméno uživatele, a v případě potřeby můžete zadat heslo.

Určit položky, které jsou ovlivněny příkazu

Itemspecs a versionspecs slouží k určení, které položky jsou ovlivněny příkazu.

Itemspec argument slouží k určení zboží

Můžete použít itemspec (specifikace zboží) a určete položky, které jsou ovlivněny příkazu.Můžete určit položky, na klientském počítači nebo na serveru Team Foundation.Můžete použít zástupné znaky, jako například * a ?.

Argumenty itemspec klienta

Argument itemspec klienta Určuje cestu k položky v počítači klienta, například ve složce (například c:\code\SiteApp\Main\SolutionA\) do souboru (například c:\code\SiteApp\Main\SolutionA\Project1\program.cs nebo více souborů (například c:\code\SiteApp\Main\SolutionA\*.cs.Můžete také zadat cesty UNC, jako \\myshare\code\SiteApp\Main.

Argumenty itemspec serveru

Server itemspec argument určuje cestu k položkám na serveru Team Foundation Server jako je například složka (například $/SiteApp/Main/SolutionA) do souboru (například $/SiteApp/Main/SolutionA/Project1/program.cs nebo více souborů (například $/SiteApp/Main/SolutionA/*.cs.

Argumenty itemspec serveru se obvykle používá, je-li třeba spustit příkaz na položky není v klientském počítači.Například při práci na počítači dev a získat některá data o revizích historie o některé položky, které jsou v kolekci týmového projektu, které nefungují v:

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

Více argumentů itemspec

U některých příkazů lze zadat více itemspec argumenty.Příklad:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Rezervuje program.cs a program2.c.

Versionspec argument slouží k určení ohrožených verzích položek

Můžete použít versionspec (verze specifikace), chcete-li určit verzi položky, které jsou ovlivněny příkazu.Chcete-li poskytnout versionspec je možné:

• Použijte parametr /version.Například: /version:C44

• Připojte versionspec itemspec středníkem.Například: program1.cs;C44

Při použití Příkaz Historie nebo Difference Command, můžete určit rozsah verzí oddělením verze znakem vlnky (~).Příklad:

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

Chcete-li určit pomocí následující syntaxe versionspec.

Type	Syntaxe	Description
Sady změn	[C]n	Určuje na základě sady změn – čísla položky.Je-li položku, která je v oboru nebyla změněna v zadané sady změn, systém má nejnovější verze položky, ke kterým došlo před zadané sady změn. Tip Můžete vynechat C je-li zadat pouze číslo. Příklady c:\code\SiteApp\Main>tf get readme.txt /v:C8 --a-- c:\code\SiteApp\Main>tf get readme.txt /v:8 --a-- c:\code\SiteApp\Main>tf get readme.txt;8 Je-li soubor readme.txt byl upraven v sady změn – 8, získá tuto verzi souboru.V opačném případě se získá nejnovější verze souboru Readme.txt před verze 8.
Popisek	Llabel	Určuje položky, které label byla použita. Příklady c:\code\SiteApp\Main>tf get readme.txt;LJulyHotFix Získá verzi souboru readme.txt, který byl označen JulyHotFix. c:\code\SiteApp\Main>tf get /version:LLastKnownGood Načte verzi všech položek označených popiskem (a odstraní ty položky, které nejsou označeny) v pracovním prostoru jak existovaly při sady změn označené jako LastKnownGood byla vytvořena, například, případně jako součást automatizovaný proces sestavení.
Datum a čas	Dyyyy-mm-ddTxx:xx – nebo – Dmm/dd/yyyy – nebo – Jakýkoli formát podporovány rozhraní.NET Framework. – nebo – Některý z formátů podporovaných v místním počítači.	Určuje sady změn na zadané datum a čas vytvoření. Příklady c:\code\SiteApp\Main>tf get /version:D2004-03-22 Aktualizace pracovního prostoru tak, aby odpovídala codebase, která existovala v 3/22/2004 v 00: 00 (půlnoc). c:\code\SiteApp\Main>tf get /version:D2004-03-22T09:00 Aktualizace pracovního prostoru tak, aby odpovídala codebase, která existovala v 3/22/2004 09: 00 (dop. 9). Další informace o rozhraní.NET Framework podporuje data a času naleznete v tématu formáty DateTime a Standardní řetězce formátu data a času.
Pracovní prostor (aktuální)	W	Určuje verzi v pracovním prostoru.
Pracovní prostor (zadaný)	Wworkspacename; workspaceowner	Určuje verzi do určeného pracovního prostoru. Například: WResolveRIConflicts;PeterW
Tip:	T	Určuje poslední verze.

Pomocí možnosti upravit jak příkaz funkce

Společné možnosti můžete upravit jak příkaz funkce.

Potlačí požadavky pro vstup dat a přesměrovat výstup dat do okna příkazového řádku pomocí příkazu /noprompt

Použití /noprompt možnost potlačí požadavky pro vstup dat a přesměrovat výstup dat do okna příkazového řádku.Tato možnost může být užitečná, pokud potřebujete použít příkazy správy verzí ve skriptu, protože příkaz pokračuje bez zásahu uživatele a data jsou k dispozici pro skript k provedení operací, jako je analýza nebo zachycení.

Použijete-li tuto možnost, systém:

• Potlačí všechny požadavky pro vstup:

  • V okně příkazového řádku nejsou nejčastější otázky.Například při použití Příkaz Vrátit zpět s touto možností systému nezobrazí výzvu k potvrzení, zda chcete pokračovat ve vrácení změn.

  • Dialogové okno systému Windows a pole se nedodávají.Například pomocí této možnosti se Příkaz Vrátit se změnami.Namísto zobrazení Vrátit se změnami dialogové k potvrzení vaší volby (zboží, které chcete vrátit se změnami nebo které pracovní položky, které chcete přidružit), systém pokračovat změnami bez potvrzení.

• Přesměruje výstup dat do příkazového řádku.Například pomocí této možnosti se Příkaz Historie.Data se zobrazí v okně příkazového řádku namísto okno historie.

Možnost Publikace1 slouží k zadání pověření při spuštění příkazu

Použití /login možnost, chcete-li určit uživatelský účet Team Foundation Server Chcete-li spustit příkaz.Tato možnost může být užitečná, pokud pracujete v počítači jiného člena týmu.

Například Julie práce s Peter na jeho dev stroje.Použije Příkaz Lock k odemknutí souboru, který uživatel uzamčen dříve:

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

Pokud chce vyhnout své heslo, které se zobrazí v okně příkazového řádku, Eva zadáním příkazu bez hesla:

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

Poté, co uživatel zadá příkaz, systém vyzve jí zadejte své heslo v dialogovém okně, které skrývá svůj vstup.

Možnost /lock k použití nebo odebrání zámku

Důležité
Jako nejvhodnější je použít /lock možnost orientačně a oznámit členům týmu, proč jsou uzamčení položky a plánujete-li odebrat zámek.

Použití /lock možnost použití nebo odebrání zámku ve stejnou dobu, jako například spustit další příkaz Přidat nebo Upravit.

/lock:(none|checkin|checkout)

• None: Žádné uzamčení se umístí na položku.Zámek je již na místě, je odstraněn.

• Checkinnebo Checkout: platí zámek.Viz téma Porozumět typy zámku.

[!POZNÁMKA]

V určitých případech může selhat operace uzamčení:

• Pokud ostatní uživatelé mají všechny zadané položky, zámek se nezdaří.

• Systém ignoruje tento přepínač, pokud již existuje čekající změny na položku.V tomto případě je nutné použít Lock Command Chcete-li změnit zámek určité položky.

Možnost použití klávesových zkratek

Lze použít následující možnosti.

Možnost	Možnost Alias
/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

Porozumět ukončovací kódy

Příkazy pro řízení verze vracet následující návratové kódy:

Kód ukončení	Definice
0	Success.
1	Částečného úspěchu; To znamená alespoň že něco, případně vše, co se nepodařilo úspěšně.
2	Nerozpoznaný příkaz.
100	Nic se zdařilo.

Příklad:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Pokud některý ze souborů, které se pokoušíte rezervovat neexistuje na serveru, vrátí příkaz 1 k označení částečného úspěchu.