Delen via

Opdracht vernietigen (Team Foundation Version Control)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Gebruik de opdracht tf destroy om bestanden met versiebeheer (TFVC) te vernietigen of permanent te verwijderen.

Notitie

Het verwijderen van een TFVC-opslagplaats in Azure Devops is niet toegestaan zodra deze is gemaakt. Met de opdracht tf destroy worden alleen bestanden of mappen met versiebeheer vernietigd of definitief verwijderd, maar wordt de TFVC-opslagplaats niet verwijderd. Het wordt nog steeds weergegeven in de lijst met opties waarbij het bericht is verwijderd.

Soms moet u versiebeheersystemen opschonen. Als sommige bestanden bijvoorbeeld zijn geïnfecteerd met een computervirus, moet u ze permanent verwijderen uit versiebeheer. Vernietig geen bestanden die nog nodig zijn. De vernietigingsactie kan niet worden omgekeerd.

Voordat u tf destroy zonder de optie /keephistory uitvoert, verwijdert u eerst de bestanden die u wilt vernietigen. Zie Bestanden en mappen verwijderen uit versiebeheervoor meer informatie.

Nadat u de bestanden hebt verwijderd, kunt u het TFVC-magazijn synchroniseren. Anders wordt het magazijn niet gesynchroniseerd met de vernietigde items.

Voorwaarden

Als u de opdracht destroy wilt gebruiken, hoort u bij de Team Foundation-beheerders beveiligingsgroep. Zie standaard TFVC-machtigingenvoor meer informatie.

Syntaxis

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

Parameters

Argumenten

argument

beschrijving

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

Hiermee geeft u het serverpad van het bestand of de map die moet worden vernietigd. Gebruik meerdere itemspec waarden om meerdere items te verwijderen. Bijvoorbeeld tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3.

Lokale paden worden niet ondersteund.

<versionspec>

Biedt een versie zoals C58 voor de /keephistory of /stopat opties. De toegestane waarden zijn date, tipof een specifieke wijzigingenset. Zie Team Foundation-versiebeheeropdrachten gebruikenvoor meer informatie over hoe TFVC een versiespecificatie parseert om te bepalen welke items binnen het bereik vallen.

<username>

Biedt een waarde voor de optie /login. U kunt een username-waarde opgeven als DOMAIN\username of username.

TeamProjectCollectionUrl

De URL van de projectverzameling die bestanden bevat die u wilt vernietigen, bijvoorbeeld http://myserver:8080/tfs/DefaultCollection.

Opties

optie

beschrijving

/keephistory

Facultatief. Hiermee geeft u op dat de geschiedenis van een bestand behouden blijft, zelfs als de inhoud ervan wordt vernietigd. Deze optie kan niet worden opgegeven met de optie /preview.

/stopat

Facultatief. Kan alleen worden gebruikt als /keephistory ook is opgegeven.

Hiermee geeft u de bestandsversie voor het bestand en de bestanden die hierna volgen, waarvoor de geschiedenis behouden blijft.

De standaardversie voor /stopat is tip (T) voor de meest recente ingecheckte versie van een item.

U kunt geen label of werkruimte gebruiken versionspec waarden om een item op te geven voor de optie /stopat.

/preview

Geeft de bestanden weer die in het opdrachtpromptvenster zouden worden vernietigd. Wanneer tf destroy wordt uitgevoerd in de preview-modus, worden de bestanden niet daadwerkelijk vernietigd.

Notitie

In de tekst in het opdrachtpromptvenster wordt het woord vernietigde weergegeven met elk bestand dat zou worden vernietigd. Het bestand wordt echter niet vernietigd wanneer de optie /preview wordt gebruikt.

/startcleanup

Dwingt het opschonen van TFVC-metagegevens onmiddellijk nadat het verwijderen is voltooid. Als de gebruiker geen /startcleanupopgeeft, vindt het opschoonproces van vernietigde metagegevens plaats wanneer het databaseonderhoud alle bestanden opschoont waarnaar niet meer wordt verwezen door Azure DevOps Server. De opschoonbewerking wordt standaard elke vijf dagen uitgevoerd. Zeven dagen nadat de TFVC-metagegevens zijn opgeschoond, wordt de inhoud verwijderd door een ander opschoningsproces. Dit opschoonproces voor inhoud wordt standaard één keer per dag uitgevoerd.

/noprompt of /i

Hiermee geeft u op dat de vernietiging van bestanden niet-interactief is. /i is een alias voor /noprompt.

/silent

Hiermee geeft u op dat wanneer u bestanden of mappen vernietigt, de uitvoer niet naar het opdrachtpromptvenster wordt geschreven.

/login

Hiermee geeft u de gebruikersnaam en het wachtwoord op om de gebruiker te verifiëren met TFVC.

/collection

Hiermee geeft u de projectverzameling op.

Opmerkingen

Wanneer u tf destroy gebruikt om versiebeheerbestanden te vernietigen, ontvangt de toepassingslaag van TFVC de vernietigingsaanvraag en controleert u of u lid bent van de Team Foundation-beheerders beveiligingsgroep. Als u geen lid bent, wordt in het systeem een foutbericht weergegeven waarin wordt aangegeven dat u niet over voldoende machtigingen beschikt om de bewerking uit te voeren.

Nadat het systeem uw machtigingen heeft geverifieerd, wordt de vernietigingsopdracht uitgevoerd. Met deze opdracht worden alle bestandsverwijzingen, plankensets en wijzigingen in behandeling verwijderd. De daadwerkelijke vernietiging van bestanden, een permanente verwijdering, gebeurt de volgende keer dat de inhoud waarnaar niet meer wordt verwezen door Azure DevOps Server, wordt opgeschoond. U kunt ook de /startcleanup optie opgeven om de bestanden onmiddellijk na tf destroy uitvoering op te schonen.

Als u tf destroy uitvoert zonder /i en /previewop te geven, geeft het systeem een console weer Ja of Geen prompt voor elke filespec waarde. Anders kunt u Ja op alleopgeven.

  • Als u geen /keephistoryopgeeft, wordt u gevraagd door een interactieve tekst die waarschuwt voor wijzigingen die in behandeling zijn, als deze bestaan. De interactieve tekst verwijst naar /preview als u meer informatie wilt over de wijzigingen.

  • Als u /keephistoryopgeeft, wordt u ook gevraagd door Ja, Nee-of Ja op alle tekst. Als u Ja of Ja op alleselecteert, wordt het vernietigingsproces gestart en worden de serverpaden naar de vernietigde items weergegeven in het opdrachtpromptvenster.

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

Als u de versionspec-waarde hebt opgegeven als tip, bevatten de serverpaden die worden weergegeven in het opdrachtpromptvenster verwijderings-id's. Destroyed: $/Test1/MyProject;X123 kan bijvoorbeeld worden weergegeven in het opdrachtpromptvenster.

Als u de optie /preview gebruikt, worden de bestanden niet vernietigd, maar de opdrachtregeltekst geeft de bestanden weer die zouden worden vernietigd. Als u bijvoorbeeld tf destroy /preview $/Test1/MyProject/MyProject/Program.cs op de opdrachtregel invoert, wordt in het opdrachtvenster deze tekst weergegeven:

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

Het bestand wordt echter niet vernietigd omdat u de optie /preview hebt gebruikt.

Zie Team Foundation-versiebeheeropdrachten gebruikenvoor meer informatie over het gebruik van het opdrachtregelprogramma tf.

Effecten van /keephistory op andere bewerkingen voor versiebeheer

Als u de /keephistory optie opgeeft om de geschiedenis van vernietigde bestanden te behouden, worden de bestanden behandeld als vernietigd door de volgende TFVC-bewerkingen:

  • Inhoudswijzigen. Als u de inhoud van een vernietigd bestand probeert te wijzigen, bijvoorbeeld bewerken of vertakkingen, geeft het systeem een foutbericht met de melding dat de inhoud is vernietigd.

  • Branch, merge of unshelve. Als u probeert vernietigde items te vertakken, samenvoegen of opheffen, geeft het systeem een foutbericht met de melding dat de inhoud van de items is vernietigd.

Eerder verwijderde items vernietigen

Als een item al is verwijderd, wordt er een verwijderings-id aan gekoppeld en wordt de bestandsnaam gewijzigd.

Met codezoekopdrachten worden tf destroy meldingen niet verwerkt. Als u dus tf destroy gebruikt voor TFVC-opslagplaatsen, worden bestanden niet automatisch uit de zoekindex verwijderd. Als gevolg hiervan worden deze bestanden weergegeven in de zoekresultaten van de code. Verwijder bestanden vóór de tf destroy bewerking om deze scenario's met ghost-bestanden te voorkomen.

Voorbeelden

In het volgende voorbeeld wordt het bestand definitief verwijderd a.cs.

tf destroy $/proj/pi/a.cs

In het volgende voorbeeld wordt een map verwijderd, aFolder-:

tf delete $/MyTeamProject/aFolder

Als u het verwijderde item wilt vernietigen aFolder-, voert u het volgende in op de opdrachtregel:

tf destroy $/MyTeamProject/aFolder;x123

waarbij x123 de verwijderings-id is.