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 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\username username. |
<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ží
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 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