Dela via

Ta bort kommando (Versionskontroll för Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Kommandot delete tar bort filer och mappar från Azure DevOps-servern och tar bort dem från disken.

Not

Resultatet av det här kommandot visas inte på andra arbetsytor förrän du utför en incheckningsåtgärd. Mer information finns i Utveckla kod och hantera väntande ändringar.

Förutsättningar

Om du vill använda kommandot delete har du behörigheten Checka ut till Tillåt. Om du inkluderar alternativet /lock med ett annat värde än nonehar du behörigheten Lock inställd på Tillåt. Du måste också äga arbetsytan eller ha den globala Administrera arbetsytor behörighet inställd på Tillåt. Mer information finns i TFVC-standardbehörigheter.

Syntax

tf delete [/lock:(none|checkin|checkout)] [/recursive] [/login:username,[password]] itemspec

Parametrar

Argument

Argument

Beskrivning

<itemspec>

Identifierar filen eller mappen som ska tas bort från Azure DevOps-servern. Mer information om hur TFVC parsar en itemspec för att avgöra vilka objekt som finns inom omfånget finns i Använda alternativ för att ändra hur en kommandofunktion.

Not

Du kan ange mer än ett itemspec argument.

<username>

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

Alternativ

alternativ

Beskrivning

/lock

Hindrar andra användare från att checka in eller checka ut de angivna objekten. Mer information finns i Förstå låstyper.

Låsalternativ:

  • none
    Standard. Inget lås tillämpas. Om du har placerat ett lås på den angivna filen tar det här alternativet bort den. Det tar inte bort ett lås som placerats av någon annan.

  • checkin
    Andra användare kan checka ut de angivna objekten, men de kan inte checka in revisioner av låsta filer förrän du släpper låset genom att utföra en incheckning. Om några andra användare har låst något av de angivna objekten misslyckas låsåtgärden.

  • checkout
    Hindrar andra användare från att checka in eller checka ut något av de angivna objekten tills du släpper låset genom att utföra en incheckning. Om några andra användare har låst något av de angivna objekten misslyckas låsåtgärden.

/recursive

Tar bort alla filer och/eller mappar och undermappar som matchar itemspec från den angivna katalogen.

  • tf delete <folder1>\<folder2> /recursive tar bort alla filer och underkataloger som finns i <mapp1>\<mapp2>och <mapp1>\<mapp2> sig själv.
  • tf delete <folder1>\<folder2> <filespec> /recursive tar bort alla filer och underkataloger som matchar filespec som finns i <mapp1>\<mapp2> och var och en av dess underkataloger, samt alla filer och underkataloger som finns i någon katalog som matchar filespec.

Till exempel i en arbetsyta som innehåller:

Folder1\AVeryLongDirectoryName med vissa filer inuti och Folder1\Folder2\AVeryImportantFile.txt,

tf delete Folder1 AVer* /recursive

tar bort Folder1\AVeryLongDirectoryName och alla dess filer och tar bort Folder1\Folder2\AVeryImportantFile.txt eftersom det matchar jokertecknet.

/login

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

Anmärkningar

Kommandot delete registrerar en väntande ändring av typen delete på arbetsytan för de objekt som du anger. När du checkar in en väntande ändring av typen delete till Azure DevOps-servern med hjälp av kommandot checkin tar TFVC bort objektet från Azure DevOps-servern men tar inte bort det permanent. Du kan hitta borttagna objekt på Azure DevOps-servern med hjälp av kommandot dir och du kan återställa borttagna objekt med hjälp av kommandot Ta bort borttagning.

Om du har tagit bort ett objekt på arbetsytan men inte har checkat in ändringen kan du återställa objektet till arbetsytan och ta bort borttagningen från listan över väntande ändringar med hjälp av kommandot Ångra.

Du kan inte ta bort ett objekt som det finns en annan väntande ändring för. Det går till exempel inte att ta bort en utcheckad fil. Om du vill ta bort sådana objekt måste du ångra den aktuella väntande ändringen med hjälp av kommandot undo.

När du checkar in en väntande borttagning markerar TFVC filen som borttagen på Azure DevOps-servern. Om du sedan kör en get av objektet från andra arbetsytor, antingen av dig eller andra användare, tas objektet bort från dessa arbetsytor.

När din itemspec anger en mapp tar TFVC som standard bort alla sina filer och undermappar och de filer som de innehåller.

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

Exempel

I följande exempel tas 314.cs bort på disken i den angivna lokala arbetsytemappen och tar sedan bort 314.cs från versionskontrollsystemet permanent när du checkar in ändringen.

tf delete 314.cs