Dela via

Kommandot Shelve (Versionskontroll för Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Kommandot Team Foundation Version Control (TFVC) shelve lagrar en uppsättning väntande ändringar, tillsammans med väntande incheckningsanteckningar, en kommentar och en lista över associerade arbetsobjekt på en Azure DevOps-server utan att checka in dem.

Förutsättningar

Om du vill använda kommandot shelve för att ta bort en hylloruppsättning måste du vara ägare till en hyllor eller Administrera ändringar på hyllan behörighet måste anges till Tillåt. Mer information finns i TFVC-standardbehörigheter.

Syntax

tf shelve  [/replace] [/comment:("comment"|@commentfile)] [shelvesetname] [/validate][/noprompt] [/login:username,[password]]

tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)] 
[/recursive] [shelvesetname] itemspec [/validate] [/noprompt] [/login:username,[password]]

tf shelve /delete shelvesetname[;owner] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parametrar

Argument

Argument Beskrivning
<commentfile> Anger en filsystemsökväg för en fil som kommentarer för hyllorna ska läsas från.
<comment> Anger kommentaren för hyllorna.
<itemspec> Identifierar de filer eller mappar som ska lagras på hyllan. Som standard läggs alla väntande ändringar i den aktuella arbetsytan på hyllan om den här parametern inte har angetts. Mer information om hur Team Foundation parsar 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.
<shelvesetname> Anger ett namn med vilket hyllorna kan hämtas från Azure DevOps-servern. Du kan ange en befintlig kombination av shelvesetname och owner, men bara om /replace också anges.

Du måste ange ett värde för den här parametern.
<owner> Identifierar den aktuella eller avsedda ägaren av hyllorna efter användarnamn. Som standard tilldelas den aktuella användaren ägarskap för hyllorna om en inte har angetts.
<username> Ger ett värde till alternativet /login. Du kan ange ett användarnamnsvärde som antingen DOMAIN\username eller username.
<TeamProjectCollectionUrl> URL:en för projektsamlingen som innehåller de filer eller mappar som du vill lägga på hyllan, till exempel http://myserver:8080/tfs/DefaultCollection/.

Alternativ

alternativ Beskrivning
/new Det valda tillståndet för varje väntande ändring som visas i dialogrutan Visual Studio Checka in, kommentaren, tillhörande arbetsobjekt, incheckningsanteckningar och orsaken till åsidosättning av incheckningsprincipen lagras på utvecklingsdatorn som väntande ändringar tills du checkar in dem. Alternativet /new rensar dessa metadata för incheckning innan du checkar in.
/move Tar bort väntande ändringar från arbetsytan när hyllorna har slutförts.
/replace Ersätter den befintliga hylloruppsättningen med samma namn och ägare som den som du anger.
/delete Tar bort den angivna hylloruppsättningen. Endast alternativet /server kan kombineras med det här alternativet. Om du inte tar med alternativet /noprompt visas ett bekräftelsemeddelande när alternativet /delete anges.
/comment Lägger till en angiven kommentar som beskriver ändringarna på hyllan.
/recursive Lägger alla objekt i den angivna hylloruppsättningsmappen, dess undermappar och alla objekt däri om den itemspec du anger är en mapp.
/noprompt Undertrycker alla uppmaningar om indata från dig.
/validate Det här alternativet markerar kryssrutan Utvärdera principer och incheckningsanteckningar innan du hyllor kryssrutan i dialogrutan Shelve – Source Files när den öppnas. När kryssrutan validering är markerad utvärderar dialogrutan incheckningsprinciperna och verifierar att incheckningsanteckningar har fyllts i. Det här alternativet är användbart när ändringarna lämnas ut för granskning och incheckning av någon annan. Ogiltigt när det kombineras med /noprompt.
/login Anger användarnamn och lösenord för att autentisera användaren med Azure DevOps Server.
/collection Anger projektsamlingen.

Anmärkningar

Kommandot shelve för kommandoradsverktyget tf säkerhetskopierar väntande ändringar, en lista över associerade arbetsobjekt, pågående incheckningsanteckningar och kommentarer i en hyllor på Azure DevOps-servern. En hyllor är ungefär som en ändringsuppsättning som inte har checkats in på servern. Precis som en ändringsuppsättning kan en hyllor hämtas från servern till en lokal arbetsyta av alla användare som har tillräcklig behörighet.

Hyllor är ett alternativ till att checka in väntande ändringar som inte har testats tillräckligt. Använd hyllor när du vill avbryta ditt arbete för att:

  • Dela en uppsättning lokala arbetsfiler med en annan utvecklare eller testare utan att checka in dina ändringar på versionskontrollservern.

  • Lägg en grupp väntande ändringar åt sidan tillfälligt utan att checka in dem, så att du i stället kan arbeta med ett problem med högre prioritet. När du har slutfört arbetet med uppgiften med hög prioritet kan du återställa ändringarna på hyllan med hjälp av kommandot Unshelve.

Om du inkluderar alternativet /move återställer shelve-kommandot varje filrevision på hyllan till basarbetsytans version som är den senaste versionen som hämtades från servern till den aktuella arbetsytan. Mer specifikt, för alla objekt som du lägger på hyllan, /move alternativet:

  • Använder Undo för att ångra de ändringar som lades på hyllan. Filerna som väntar på tillägg tas bort från arbetsytan.

  • Hämtar basarbetsytans versioner av alla filer som väntar på utgåvor finns från servern till den aktuella arbetsytan.

  • Markerar alla objekt i den aktuella arbetsytan med skrivskydd.

Om du inkluderar alternativet /delete tar TFVC permanent bort den angivna hylloruppsättningen från Azure DevOps-servern.

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

Exempel

I följande exempel skapas en ny hylloruppsättning på Azure DevOps-servern med namnet Reflector_BuddyTest, tilldelar ägarskap till användaren Pat, returnerar alla objekt i den aktuella arbetsytan till den senaste versionen som laddades ned under den senaste get-åtgärden och anger ett skrivskyddat tillstånd:

c:\projects> tf shelve Reflector_BuddyTest;Pat /move

Följande exempel tar bort den befintliga hylloruppsättningen new-feature från servern, skapar en ny hyllor med det namnet och behåller alla väntande ändringar i den aktuella arbetsytan:

c:\projects> tf shelve new-feature /replace

I följande exempel skapas en hylloruppsättning med namnet HelloWorld_TestMe som innehåller alla väntande ändringar i alla .cs filer i C:\projects arbetsmapp och dess undermappar:

c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive

I följande exempel tas HelloWorld_24 hyllor bort:

c:\projects> tf shelve HelloWorld_24 /delete