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

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

Kommentar

Det går inte att ta bort en TFVC-lagringsplats i Azure Devops när den har skapats. Kommandot tf destroy förstör, eller tar bort, versionskontrollerade filer eller mappar permanent, 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 destroy kommandot måste du tillhöra 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. Exempel: tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3

Lokala sökvägar stöds inte.

<versionspec>

Tillhandahåller en version, till exempel C58 för /keephistory alternativen 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 alternativet ett värde /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

Valfritt. 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

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

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 arbetsytevärden versionspec för att ange ett objekt för /stopat alternativet.

/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.

Kommentar

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 /startcleanupinträffar 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.

Kommentarer

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 säkerhetsgruppen Team Foundation-administratörer . 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 /i ange och /previewvisar systemet en ja- eller nej-fråga för varje filespec värde i konsolen. 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 texten Ja, Nej eller Ja till Alla . Om du väljer Ja eller Ja till Alla startar destruktionsprocessen och serversökvägarna till de förstörda objekten visas i kommandotolkens fönster.

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

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

Om du använder /preview alternativet 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 den här texten 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 tf kommandoradsverktyget finns i Använda Team Foundation-versionskontrollkommandon.

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

Om du anger /keephistory alternativet 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.

  • Förgrena, sammanfoga eller ta bort hjälp. 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 tf destroy inte meddelanden, så användning för tf destroy TFVC-lagringsplatser tar inte automatiskt bort filer från sökindexet. Därför visas dessa filer i kodsökningsresultatet. För att undvika dessa scenarier för spökfiler tar du bort filer före åtgärden tf destroy .

Exempel

I följande exempel tas filen a.cs bort 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 aFolder anger du på kommandoraden:

tf destroy $/MyTeamProject/aFolder;x123

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