Share via

Příkaz Shelve (Správa verzí Team Foundation)

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Příkaz Správa verzí Team Foundation (TFVC) 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ž byste je skutečně zkontrolovali.

Požadavky

Pokud chcete příkaz použít shelve k odstranění sady odložených změn, musíte být vlastníkem sady odložených odložených změn nebo musíte mít oprávnění Správa ister shelved changes nastaveno na Povolit. Další informace naleznete v tématu Výchozí oprávnění TFVC.

Syntaxe

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

Argument 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 , aby určil, které položky jsou v rozsahu, naleznete v tématu Použití možností k úpravě způsobu fungování příkazu.
<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 /replace je zadána.

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 možnosti /login . Hodnotu uživatelského jména můžete zadat buď nebo DOMAIN\usernameusername.
<TeamProjectCollectionUrl> Adresa URL kolekce projektů, která obsahuje soubory nebo složky, které chcete například shelve http://myserver:8080/tfs/DefaultCollection/.

Možnosti

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 v sadě Visual Studio, 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, jsou uložené na vývojovém počítači 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í. /server Tuto možnost lze kombinovat pouze s touto možností. Pokud tuto možnost nezadáte /noprompt , zobrazí se /delete po zadání možnosti 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í podsložky a všechny položky v ní, pokud itemspec je zadaná složka.
/noprompt Potlačí všechny výzvy k zadání vstupu od vás.
/validate Tato možnost zaškrtne políčko Vyhodnotit zásady a check-in poznámky před zaškrtnutím políčka v dialogovém okně Shelve – Zdrojové soubory při otevření. Když je zaškrtnuté políčko ověření, dialogové okno vyhodnotí zásady vrácení se změnami a ověří, jestli byly vyplněné poznámky k vrácení se změnami. Tato možnost je užitečná, když se změny předávají ke kontrole a vrácení se změnami někým jiným. Není platné v kombinaci s /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 tf řádku 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 tuto možnost zahrnete /move , shelve příkaz vrátí zpět každou revizi souboru shelved na základní verzi pracovního prostoru, která je poslední verzí načtenou ze serveru do aktuálního pracovního prostoru. Konkrétně pro všechny položky, které shelve, /move možnost:

  • Slouží Undo k 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 tuto /delete možnost zahrnete, TFVC trvale odebere zadanou sadu odložených odložených dat ze serveru Azure DevOps.

Další informace o tom, jak používat nástroj příkazového tf řádku, 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í uživateli Patvlastnictví , vrátí všechny položky v aktuálním pracovním prostoru na nejnovější verzi staženou během poslední get operace a nastaví stav jen pro čtení:

c:\projects> tf shelve Reflector_BuddyTest;Pat /move

Následující příklad odstraní existující sadu new-feature odložených změn 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 HelloWorld_TestMe odložených změn, která obsahuje všechny čekající změny všech .cs souborů v pracovní složce C:\projects a jejích podsložkách:

c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive

Následující příklad odstraní HelloWorld_24 sadu odložených položek:

c:\projects> tf shelve HelloWorld_24 /delete