Příkaz Shelve (Správa verzí Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Příkaz TFVC (Team Foundation Version Control) shelve ukládá sadu čekajících změn společně s čekajícími poznámkami k vrácení se změnami, komentářem a seznamem přidružených pracovních položek na serveru Azure DevOps, aniž by je skutečně zkontroloval.
Požadavky
Pokud chcete pomocí příkazu shelve odstranit sadu odložených změn, být vlastníkem sady odložených odložených změn nebo Spravovat změny musí být nastavena na Povolit. Další informace najdete v tématu Výchozí oprávnění TFVC.
Syntax
tf shelve [/replace] [/comment:("comment"|@commentfile)] [shelvesetname] [/validate][/noprompt] [/login:username,[password]]
tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)]
[/recursive] [shelvesetname] itemspec [/validate] [/noprompt] [/login:username,[password]]
tf shelve /delete shelvesetname[;owner] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parametry
Argumenty
| argumentu |
popis |
|---|---|
<commentfile> |
Určuje cestu k systému souborů souboru, ze kterého by se měly číst komentáře sady odložených odložených souborů. |
<comment> |
Určuje komentář sady odložených odložených polí. |
<itemspec> |
Identifikuje soubory nebo složky, které mají být shelve. Ve výchozím nastavení se všechny čekající změny v aktuálním pracovním prostoru přeloží, pokud tento parametr není zadaný. Další informace o tom, jak Team Foundation analyzuje itemspec určit, které položky jsou v rozsahu, najdete v tématu Použití možností k úpravě způsobu fungování příkazů. |
<shelvesetname> |
Určuje název, podle kterého lze sadu odložených odložených dat načíst ze serveru Azure DevOps. Můžete zadat existující kombinaci shelvesetname a owner, ale pouze pokud je zadána /replace.Pro tento parametr musíte zadat hodnotu. |
<owner> |
Identifikuje aktuálního nebo zamýšleného vlastníka sady odložených dat podle uživatelského jména. Ve výchozím nastavení má aktuální uživatel přiřazené vlastnictví sady odložených dat, pokud není zadaný. |
<username> |
Poskytuje hodnotu /login možnosti. Hodnotu uživatelského jména můžete zadat buď jako DOMAIN\username, nebo username. |
<TeamProjectCollectionUrl> |
Adresa URL kolekce projektů, která obsahuje soubory nebo složky, které chcete shelve, například http://myserver:8080/tfs/DefaultCollection/. |
Volby
| možnost | popis |
|---|---|
/new |
Vybraný stav každé čekající změny, jak je znázorněno v dialogovém okně vrácení se změnami, komentář, přidružené pracovní položky, poznámky k vrácení se změnami a důvod přepsání zásad vrácení se změnami, se na vývojovém počítači ukládají jako čekající změny, dokud je nekontrolujete. Možnost /new zruší zaškrtnutí tohoto metadata vrácení se změnami před vrácením se změnami. |
/move |
Po úspěšné operaci shelve odebere z pracovního prostoru čekající změny. |
/replace |
Nahradí existující sadu odložených odložených polí stejným názvem a vlastníkem jako ten, který zadáte. |
/delete |
Odstraní zadanou sadu odložených odložených polí. Tuto možnost lze kombinovat pouze s možností /server. Pokud možnost /noprompt nezadáte, zobrazí se po zadání možnosti /delete potvrzovací zpráva. |
/comment |
Přidá zadaný komentář popisující změny s přeloženou úpravou. |
/recursive |
Odloží všechny položky v zadané složce sady odložených položek, jejích podsložek a všech položek, pokud itemspec zadáte, je složka. |
/noprompt |
Potlačí všechny výzvy k zadání vstupu od vás. |
/validate |
Tato možnost zaškrtne políčko /noprompt. |
/login |
Určuje uživatelské jméno a heslo pro ověření uživatele pomocí Azure DevOps Serveru. |
/collection |
Určuje kolekci projektů. |
Poznámky
Příkaz shelve nástroje příkazového řádku tf zálohuje čekající změny, seznam přidružených pracovních položek, probíhajících poznámek k vrácení se změnami a komentáře v sadě odložených změn na serveru Azure DevOps. Sada odložených změn se podobá sadě změn, která není potvrzena na server. Podobně jako sadu změn může sada odložených změn načíst ze serveru do místního pracovního prostoru každý uživatel, který má dostatečná oprávnění.
Shelving je alternativou k vrácení čekajících změn, které nebyly dostatečně testovány. Pokud chcete přerušit práci, použijte:
Sdílejte sadu místních pracovních souborů s jiným vývojářem nebo testerem bez vrácení změn na server správy verzí.
Vyhradte skupinu čekajících změn dočasně bez jejich vrácení se změnami, abyste místo toho mohli pracovat na problému s vyšší prioritou. Po dokončení práce na úkolu s vysokou prioritou můžete obnovit provedené změny pomocí příkazu Unshelve.
Pokud zahrnete možnost /move, příkaz shelve vrátí zpět každou revizi souboru s základní verzí pracovního prostoru, která je poslední verzí načtená ze serveru do aktuálního pracovního prostoru. Konkrétně pro všechny položky, které shelve, /move možnost:
Používá
Undok vrácení změn, které byly změněny. Soubory čekající na přidání se z pracovního prostoru odstraní.Načte základní verze pracovních prostorů všech souborů, pro které existují čekající edice ze serveru, do aktuálního pracovního prostoru.
Označí všechny položky v aktuálním pracovním prostoru jen pro čtení.
Pokud zahrnete možnost /delete, TFVC trvale odebere zadanou sadu odložených dat ze serveru Azure DevOps.
Další informace o použití nástroje příkazového řádku tf naleznete v tématu Použití příkazů správy verzí Team Foundation.
Příklady
Následující příklad vytvoří novou sadu odložených položek na serveru Azure DevOps s názvem Reflector_BuddyTest, přiřadí vlastnictví uživateli Pat, vrátí všechny položky v aktuálním pracovním prostoru na nejnovější verzi staženou během poslední operace get a nastaví stav jen pro čtení:
c:\projects> tf shelve Reflector_BuddyTest;Pat /move
Následující příklad odstraní existující sadu odložených změn new-feature ze serveru, vytvoří novou sadu odložených změn podle tohoto názvu a zachová všechny čekající změny v aktuálním pracovním prostoru:
c:\projects> tf shelve new-feature /replace
Následující příklad vytvoří sadu odložených změn s názvem HelloWorld_TestMe, která zahrnuje všechny čekající změny všech souborů .cs ve C:\projects pracovní složce a jejích podsložkách:
c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive
Následující příklad odstraní sadu odložených HelloWorld_24:
c:\projects> tf shelve HelloWorld_24 /delete