Sdílet prostřednictvím

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

  • Článek

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

Visual Studio 2019 | Visual Studio 2022

Pomocí příkazu tf destroy zničíte nebo trvale odstraníte soubory řízené verzí ze správy verzí Team Foundation (TFVC).

Poznámka

Odstranění úložiště TFVC uvnitř Azure DevOps není po vytvoření povolené. Příkaz tf destroy zničí nebo trvale odstraní soubory nebo složky řízené verzí, ale neodstraní úložiště TFVC. Bude se stále zobrazovat v seznamu možností s odstraněnou zprávou.

Někdy je potřeba vyčistit systémy správy verzí. Pokud jsou například některé soubory napadené počítačovým virem, musíte je trvale odebrat ze správy verzí. Nezničte soubory, které jsou stále potřeba. Akci zničení nelze vrátit zpět.

Před spuštěním tf destroy bez možnosti /keephistory nejprve odstraňte soubory, které chcete zničit. Další informace najdete v tématu Odstranění souborů a složek ze správy verzí.

Po odstranění souborů můžete synchronizovat sklad TFVC. Jinak se sklad nebude synchronizovat s zničenými položkami.

Požadavky

Pokud chcete použít příkaz destroy, patří do skupiny zabezpečení Team Foundation Administrators. Další informace najdete v tématu Výchozí oprávnění TFVC.

Syntax

tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>...<itemspecN>] 
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]

Parametry

Argumenty

argumentu

popis

<itemspec1> [<itemspec2>...<itemspecN>]

Určuje cestu k serveru souboru nebo složky, které se mají zničit. K odstranění více položek použijte více hodnot itemspec. Například tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3.

Místní cesty se nepodporují.

<versionspec>

Poskytuje verzi, například C58 pro možnosti /keephistory nebo /stopat. Povolené hodnoty jsou date, tipnebo konkrétní sadu změn. Další informace o tom, jak TFVC parsuje specifikaci verze k určení položek v jeho oboru, najdete v tématu Použití příkazů správy verzí Team Foundation.

<username>

Poskytuje hodnotu /login možnosti. Hodnotu username můžete zadat buď jako DOMAIN\username, nebo username.

TeamProjectCollectionUrl

Adresa URL kolekce projektu, která obsahuje soubory, které chcete zničit, například http://myserver:8080/tfs/DefaultCollection.

Volby

možnost

popis

/keephistory

Volitelný. Určuje, že historie souboru je zachována, i když je jeho obsah zničen. Tuto možnost nelze zadat pomocí možnosti /preview.

/stopat

Volitelný. Lze použít pouze v případě, že je zadán také /keephistory.

Určuje verzi souboru souboru a soubory, které následují dále, pro které je historie zachována.

Výchozí verze pro /stopat je tip (T) pro nejnovější vrácenou verzi položky.

Popisek nebo pracovní prostor nemůžete použít versionspec hodnoty k zadání položky pro /stopat možnost.

/preview

Zobrazí soubory, které by byly zničeny v okně příkazového řádku. Když se tf destroy spustí v režimu náhledu, soubory se ve skutečnosti nezničí.

Poznámka

Text v okně příkazového řádku zobrazí slovo Zničeno s každým souborem, který by byl zničen. Pokud se však použije možnost /preview, soubor se ve skutečnosti nezničí.

/startcleanup

Vynutí, aby se proces vyčištění metadat TFVC spustil okamžitě po dokončení odstranění. Pokud uživatel nezadá /startcleanup, dojde k procesu vyčištění zničených metadat, když údržba databáze vyčistí všechny soubory, na které už Azure DevOps Server neodkazuje. Ve výchozím nastavení je naplánované spuštění čištění každých pět dnů. Sedm dní po vyčištění metadat TFVC se obsah odstraní jiným procesem čištění. Ve výchozím nastavení se tento proces čištění obsahu spouští jednou denně.

/noprompt nebo /i

Určuje, že zničení souborů není interaktivní. /i je alias pro /noprompt.

/silent

Určuje, že když zničíte soubory nebo složky, výstup se nezapíše do okna příkazového řádku.

/login

Určuje uživatelské jméno a heslo pro ověření uživatele pomocí TFVC.

/collection

Určuje kolekci projektů.

Poznámky

Když použijete tf destroy ke zničení souborů správy verzí, aplikační vrstva TFVC obdrží žádost o zničení a zkontroluje, jestli jste členem Team Foundation Administrators skupiny zabezpečení. Pokud nejste členem, zobrazí se v systému dialogové okno s chybovou zprávou s oznámením, že nemáte dostatečná oprávnění k provedení operace.

Jakmile systém ověří vaše oprávnění, spustí příkaz destroy. Tento příkaz odstraní všechny odkazy na soubory, sady odložených změn a čekající změny. Skutečné zničení souborů, což je trvalé odstranění, nastane při příštím vyčištění obsahu, na který už Azure DevOps Server odkazuje. Můžete také zadat možnost /startcleanup, která soubory okamžitě po spuštění tf destroy vyčistí.

Pokud spustíte tf destroy bez zadání /i a /preview, systém zobrazí konzolu Ano nebo Ne výzvy pro každou hodnotu filespec. V opačném případě můžete zadat Ano pro všechny.

  • Pokud nezadáte /keephistory, zobrazí se výzva interaktivním textem, který varuje čekající změny, pokud existují. Interaktivní text odkazuje na /preview, pokud chcete další informace o změnách.

  • Pokud zadáte /keephistory, zobrazí se také výzva Ano, Nenebo Ano všem textu. Pokud vyberete Ano nebo Ano všem, spustí se proces zničení a v okně příkazového řádku se zobrazí cesty serveru ke zničeným položkám.

Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: ...

Pokud jste zadali hodnotu versionspec jako tip, cesty k serveru zobrazené v okně příkazového řádku obsahují ID odstranění. Například Destroyed: $/Test1/MyProject;X123 se může zobrazit v okně příkazového řádku.

Pokud použijete možnost /preview, soubory se nezničí, ale text příkazového řádku zobrazí soubory, které by byly zničeny. Pokud například zadáte tf destroy /preview $/Test1/MyProject/MyProject/Program.cs na příkazovém řádku, zobrazí se v příkazovém okně tento text:

Destroyed: $/Test1/MyProject/MyProject/Program.cs

Soubor se ale ve skutečnosti nezničí, protože jste použili možnost /preview.

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.

Účinky /keephistory na jiné operace správy verzí

Pokud zadáte možnost /keephistory zachovat historii zničených souborů, budou se soubory považovat za zničené pomocí následujících operací TFVC:

  • Změnit obsah. Pokud se pokusíte změnit obsah zničeného souboru, například úpravu nebo větev, systém vydá chybovou zprávu s informacemi o tom, že byl obsah zničen.

  • větev, sloučení nebo zrušení. Pokud se pokusíte zvětšovat, sloučit nebo zrušit odstraněné položky, systém vydá chybovou zprávu, která uvádí, že obsah položek byl zničen.

Zničit dříve odstraněné položky

Pokud již byla položka odstraněna, je k ní připojeno ID odstranění a výsledkem je změna názvu souboru.

Vyhledávání kódu nezpracovává tf destroy oznámení, takže použití tf destroy pro úložiště TFVC automaticky neodstraní soubory z indexu vyhledávání. V důsledku toho se tyto soubory zobrazí ve výsledcích hledání kódu. Pokud se chcete těmto scénářům stínových souborů vyhnout, odstraňte soubory před operací tf destroy.

Příklady

Následující příklad trvale odstraní soubor a.cs.

tf destroy $/proj/pi/a.cs

Následující příklad odstraní složku, aFolder:

tf delete $/MyTeamProject/aFolder

Pokud chcete odstranit odstraněnou položku folderu, zadejte na příkazový řádek:

tf destroy $/MyTeamProject/aFolder;x123

kde x123 je ID odstranění.