Delen via


Opdracht vernietigen (Team Foundation Version Control)

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

Visual Studio 2019 | Visual Studio 2022

Gebruik de tf destroy opdracht 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 zonder de /keephistory optie uitvoerttf destroy, verwijdert u eerst de bestanden die u wilt vernietigen. Zie Bestanden en mappen verwijderen uit versiebeheer voor meer informatie.

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

Vereisten

Als u de destroy opdracht wilt gebruiken, moet u deel uitmaken van de beveiligingsgroep Team Foundation Beheer istrators. Zie Standaard TFVC-machtigingen voor 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 gebruiken voor meer informatie over hoe TFVC een versiespecificatie parseert om te bepalen welke items binnen het bereik vallen.

<username>

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

TeamProjectCollectionUrl

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

Opties

Optie

Beschrijving

/keephistory

Optioneel. 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 /preview optie.

/stopat

Optioneel. Kan alleen worden gebruikt als /keephistory deze ook is opgegeven.

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

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

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

/preview

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

Notitie

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

/startcleanup

Dwingt het opschonen van TFVC-metagegevens onmiddellijk nadat het verwijderen is voltooid. Als de gebruiker niet opgeeft /startcleanup, 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 versiebeheerbestanden tf destroy verwijdert, ontvangt de toepassingslaag van TFVC de vernietigingsaanvraag en controleert u of u lid bent van de Team Foundation-beveiligingsgroep Beheer istrators. 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 zonder tf destroy op te geven /i en /preview, geeft het systeem een console Ja of Nee-prompt weer voor elke filespec waarde. Anders kunt u Ja op Alles opgeven.

  • Als u dit niet opgeeft /keephistory, 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 opgeeft /keephistory, wordt u ook gevraagd door Ja, Nee of Ja op alle tekst. Als u Ja of Ja op Alles selecteert, 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 als tiphebt opgegeven, bevatten de serverpaden die worden weergegeven in het opdrachtpromptvenster verwijderings-id's. Kan bijvoorbeeld Destroyed: $/Test1/MyProject;X123 worden weergegeven in het opdrachtpromptvenster.

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

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

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

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

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:

  • Inhoud wijzigen. 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.

  • Vertakking, samenvoeging of uithelven. 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.

Codezoekopdrachten verwerken tf destroy geen meldingen, dus als u tf destroy voor TFVC-opslagplaatsen gebruikt, 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, aFolder, verwijderd:

tf delete $/MyTeamProject/aFolder

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

tf destroy $/MyTeamProject/aFolder;x123

waar x123 is de verwijderings-id.