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

tf destroy Pomocí příkazu z Správa verzí Team Foundation (TFVC) odstraňte nebo trvale odstraňte soubory řízené verzí.

Poznámka:

Odstranění úložiště TFVC uvnitř Azure DevOps není po vytvoření povolené. Příkaz tf destroy zničí nebo trvale odstraní pouze 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 /keephistory možnosti 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

Chcete-li použít destroy příkaz, musíte patřit do skupiny zabezpečení Team Foundation Správa istrators. Další informace naleznete v tématu Výchozí oprávnění TFVC.

Syntaxe

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

Parametry

Argumenty

Argument

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 itemspec hodnot. Například tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3.

Místní cesty se nepodporují.

<versionspec>

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

<username>

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

TeamProjectCollectionUrl

Adresa URL kolekce projektů, která obsahuje soubory, které chcete zničit, http://myserver:8080/tfs/DefaultCollectionnapříklad .

Možnosti

Možnost

Popis

/keephistory

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

/stopat

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

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

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

K zadání položky pro tuto /stopat možnost nemůžete použít hodnoty popisku ani pracovního prostoruversionspec.

/preview

Zobrazí soubory, které by byly zničeny v okně příkazového řádku. Když tf destroy se 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. Při použití možnosti se ale soubor ve skutečnosti nezničí /preview .

/startcleanup

Vynutí, aby se proces vyčištění metadat TFVC spustil okamžitě po dokončení odstranění. Pokud uživatel nezadá /startcleanup, proces vyčištění zničených metadat nastane, 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 skupiny zabezpečení Team Foundation Správa istrators. 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é určit možnost vyčištění /startcleanup souborů ihned po tf destroy spuštění.

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

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

  • Pokud zadáte /keephistory, zobrazí se výzva, jestli má text Ano, Ne nebo Ano . Pokud vyberete Ano nebo Ano všem, proces zničení se spustí 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 versionspec hodnotu jako tip, cesty k serveru zobrazené v okně příkazového řádku obsahují ID odstranění. Může se například Destroyed: $/Test1/MyProject;X123 zobrazit v okně příkazového řádku.

Pokud použijete /preview tuto možnost, 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ý řádek, 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 /preview možnost.

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.

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

Pokud zadáte /keephistory možnost zachování historie zničených souborů, budou se soubory považovat za zničené následujícími operacemi TFVC:

  • Umožňuje 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íhelvu 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 ú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 tf destroy operací.

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 aFolder, zadejte na příkazovém řádku:

tf destroy $/MyTeamProject/aFolder;x123

kde x123 je ID odstranění.