Dela via

Kommandot Destroy (Versionskontroll för Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Använd kommandot tf destroy för att förstöra eller permanent ta bort versionskontrollerade filer från Team Foundation Version Control (TFVC).

Not

Det går inte att ta bort en TFVC-lagringsplats i Azure Devops när den har skapats. Kommandot tf destroy kommer endast att förstöra eller permanent ta bort versionskontrollerade filer eller mappar, men tar inte bort TFVC-lagringsplatsen. Det visas fortfarande i listan med alternativ med meddelandet borttaget.

Ibland måste du rensa versionskontrollsystem. Om vissa filer till exempel är infekterade med ett datorvirus måste du ta bort dem permanent från versionskontroll. Förstör inte filer som fortfarande behövs. Förintingsåtgärden kan inte ångras.

Innan du kör tf destroy utan alternativet /keephistory tar du först bort de filer som du vill förstöra. Mer information finns i Ta bort filer och mappar från versionskontroll.

När du har tagit bort filerna kan du synkronisera TFVC-lagret. Annars synkroniseras inte lagret med de förstörda objekten.

Förutsättningar

Om du vill använda kommandot destroy tillhör du säkerhetsgruppen Team Foundation-administratörer. Mer information finns i TFVC-standardbehörigheter.

Syntax

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

Parametrar

Argument

Argument

Beskrivning

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

Anger serversökvägen för den fil eller mapp som ska förstöras. Använd flera itemspec värden för att ta bort flera objekt. Till exempel tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3.

Lokala sökvägar stöds inte.

<versionspec>

Innehåller en version som C58 för alternativen /keephistory eller /stopat. De tillåtna värdena är date, tipeller en specifik ändringsuppsättning. Mer information om hur TFVC parsar en versionsspecifikation för att avgöra vilka objekt som ligger inom dess omfång finns i Använda Team Foundation-versionskontrollkommandon.

<username>

Ger ett värde till alternativet /login. Du kan ange ett username värde som antingen DOMAIN\username eller username.

TeamProjectCollectionUrl

URL:en för projektsamlingen som innehåller filer som du vill förstöra, till exempel http://myserver:8080/tfs/DefaultCollection.

Alternativ

alternativ

Beskrivning

/keephistory

Valfri. Anger att historiken för en fil bevaras även när dess innehåll förstörs. Det här alternativet kan inte anges med alternativet /preview.

/stopat

Valfri. Kan endast användas om /keephistory också anges.

Anger filversionen för filen och de filer som följer därefter, för vilka historiken bevaras.

Standardversionen för /stopat är tip (T) för den senaste incheckade versionen av ett objekt.

Du kan inte använda etikett eller arbetsyta versionspec värden för att ange ett objekt för alternativet /stopat.

/preview

Visar de filer som skulle förstöras i kommandotolkens fönster. När tf destroy körs i förhandsgranskningsläge förstörs inte filerna.

Not

Texten i kommandotolken visar ordet Förstörd med varje fil som skulle förstöras. Filen förstörs dock inte när alternativet /preview används.

/startcleanup

Tvingar rensningen av TFVC-metadata att starta omedelbart efter att borttagningen har slutförts. Om användaren inte anger /startcleanupsker rensningsprocessen för förstörda metadata när databasunderhållet rensar alla filer som inte längre refereras till av Azure DevOps Server. Som standard är rensningen schemalagd att köras var femte dag. Sju dagar efter att TFVC-metadata har rensats tas innehållet bort av en annan rensningsprocess. Som standard körs den här rensningsprocessen en gång varje dag.

/noprompt eller /i

Anger att destruktionen av filer inte är interaktiv. /i är ett alias för /noprompt.

/silent

Anger att när du förstör filer eller mappar skrivs inte utdata till kommandotolkens fönster.

/login

Anger användarnamn och lösenord för att autentisera användaren med TFVC.

/collection

Anger projektsamlingen.

Anmärkningar

När du använder tf destroy för att förstöra versionskontrollfiler tar programnivån för TFVC emot begäran om att förstöra och kontrollerar om du är medlem i Team Foundation-administratörer säkerhetsgrupp. Om du inte är medlem visar systemet en dialogruta med felmeddelanden som anger att du inte har tillräcklig behörighet för att utföra åtgärden.

När systemet har verifierat dina behörigheter kör det kommandot destroy. Det här kommandot tar bort alla filreferenser, hyllor och väntande ändringar. Den faktiska förstörelsen av filer, vilket är en permanent borttagning, sker nästa gång innehållet som inte längre refereras till av Azure DevOps Server rensas. Du kan också ange alternativet /startcleanup för att rensa filerna direkt efter tf destroy körningar.

Om du kör tf destroy utan att ange /i och /previewvisar systemet en konsol Ja eller Ingen fråga för varje filespec värde. Annars kan du ange Ja till Alla.

  • Om du inte anger /keephistoryuppmanas du av en interaktiv text som varnar för väntande ändringar, om de finns. Den interaktiva texten pekar på /preview om du vill ha mer information om ändringarna.

  • Om du anger /keephistoryuppmanas du också av Ja, Nejeller Ja till alla text. Om du väljer Ja eller Ja till Allastartar destruktionsprocessen och serversökvägarna till de förstörda objekten visas i kommandotolkens fönster.

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

Om du angav värdet versionspec som tipinnehåller serversökvägarna som visas i kommandotolken borttagnings-ID:t. Till exempel kan Destroyed: $/Test1/MyProject;X123 visas i kommandotolkens fönster.

Om du använder alternativet /preview förstörs inte filerna, men kommandoradstexten visar de filer som skulle förstöras. Om du till exempel anger tf destroy /preview $/Test1/MyProject/MyProject/Program.cs på kommandoraden visas följande text i kommandofönstret:

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

Filen förstörs dock inte eftersom du använde alternativet /preview.

Mer information om hur du använder kommandoradsverktyget tf finns i Använda Team Foundation-versionskontrollkommandon.

Effekter av /keephistory på andra versionskontrollåtgärder

Om du anger alternativet /keephistory för att behålla historiken för förstörda filer behandlas filerna som förstörda av följande TFVC-åtgärder:

  • Ändra innehåll. Om du försöker ändra innehållet i en förstörd fil, till exempel redigera eller gren, utfärdar systemet ett felmeddelande som anger att innehållet har förstörts.

  • Branch, merge eller unshelve. Om du försöker förgrena, sammanfoga eller ta bort förstörda objekt, utfärdar systemet ett felmeddelande som anger att innehållet i objekten har förstörts.

Förstöra tidigare borttagna objekt

Om ett objekt redan har tagits bort kopplas ett borttagnings-ID till det och resulterar i en filnamnsändring.

Kodsökningen hanterar inte tf destroy meddelanden, så om du använder tf destroy för TFVC-lagringsplatser tas inte filer från sökindexet bort automatiskt. Därför visas dessa filer i kodsökningsresultatet. För att undvika dessa scenarier med spökfiler tar du bort filer innan tf destroy åtgärden.

Exempel

I följande exempel tas filen a.csbort permanent.

tf destroy $/proj/pi/a.cs

I följande exempel tas en mapp bort, aFolder:

tf delete $/MyTeamProject/aFolder

Om du vill förstöra det borttagna objektet aFolderanger du på kommandoraden:

tf destroy $/MyTeamProject/aFolder;x123

där x123 är borttagnings-ID:t.