Delen via

Shelve command (Team Foundation Version Control)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Met de opdracht Team Foundation Version Control (TFVC) shelve worden een set in behandeling zijnde wijzigingen opgeslagen, samen met in behandeling zijnde check-innotities, een opmerking en een lijst met gekoppelde werkitems op een Azure DevOps-server zonder ze daadwerkelijk in te checken.

Voorwaarden

Als u de opdracht wilt gebruiken om een plankenset te verwijderen, eigenaar van een plankenset te zijn of uw Wijzigingen in de wilt beheren, moet deze zijn ingesteld op Toestaan. Zie standaard TFVC-machtigingenvoor meer informatie.

Syntaxis

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]

Parameters

Argumenten

argument beschrijving
<commentfile> Hiermee geeft u een bestandssysteempad van een bestand waaruit opmerkingen voor de plankenset moeten worden gelezen.
<comment> Hiermee geeft u de opmerking voor de plankenset.
<itemspec> Hiermee worden de bestanden of mappen geïdentificeerd die op de plank moeten worden weergegeven. Alle wijzigingen die in behandeling zijn in de huidige werkruimte, worden standaard op de plank weergegeven als deze parameter niet is opgegeven. Zie Opties gebruiken om te wijzigen hoe een opdracht functioneertvoor meer informatie over hoe Team Foundation de itemspec parseert om te bepalen welke items binnen het bereik vallen.
<shelvesetname> Hiermee geeft u een naam op waarmee de plankenset kan worden opgehaald van de Azure DevOps-server. U kunt een bestaande combinatie van shelvesetname en owneropgeven, maar alleen als /replace ook is opgegeven.

U moet een waarde opgeven voor deze parameter.
<owner> Identificeert de huidige of beoogde eigenaar van de plankenset op gebruikersnaam. De huidige gebruiker krijgt standaard het eigendom van de plankenset toegewezen als deze niet is opgegeven.
<username> Biedt een waarde voor de optie /login. U kunt een gebruikersnaamwaarde opgeven als DOMAIN\username of username.
<TeamProjectCollectionUrl> De URL van de projectverzameling die de bestanden of mappen bevat die u wilt verwijderen, bijvoorbeeld http://myserver:8080/tfs/DefaultCollection/.

Opties

optie beschrijving
/new De geselecteerde status van elke wijziging die in behandeling is, zoals wordt weergegeven in visual studio dialoogvenster Inchecken, de opmerking, gekoppelde werkitems, inchecknotities en reden voor het overschrijven van het inchecken van beleid, worden opgeslagen op uw ontwikkelcomputer als wijzigingen die in behandeling zijn totdat u ze hebt ingecheckt. Met de optie /new worden deze metagegevens voor inchecken gewist voordat u het incheckt.
/move Verwijdert wachtende wijzigingen uit de werkruimte nadat de plankbewerking is voltooid.
/replace Vervangt de bestaande plankenset door dezelfde naam en eigenaar als degene die u opgeeft.
/delete Hiermee verwijdert u de opgegeven plankenset. Alleen de /server optie kan worden gecombineerd met deze optie. Als u de optie /noprompt niet opneemt, wordt er een bevestigingsbericht weergegeven wanneer de optie /delete is opgegeven.
/comment Hiermee voegt u een opgegeven opmerking toe waarin de wijzigingen in de rekken worden beschreven.
/recursive Plan alle items in de opgegeven map plankenset, de bijbehorende submappen en alle items daarin als de itemspec die u opgeeft een map is.
/noprompt Onderdrukt eventuele aanwijzingen voor invoer van u.
/validate Met deze optie selecteert u het selectievakje Beleid evalueren en notities inchecken voordat u selectievakje in het dialoogvenster bronbestanden opent. Wanneer het validatievak is ingeschakeld, evalueert het dialoogvenster het incheckbeleid en controleert of check-innotities zijn ingevuld. Deze optie is handig wanneer de wijzigingen door iemand anders worden beoordeeld en ingecheckt. Niet geldig in combinatie met /noprompt.
/login Hiermee geeft u de gebruikersnaam en het wachtwoord op om de gebruiker te verifiëren met Azure DevOps Server.
/collection Hiermee geeft u de projectverzameling op.

Opmerkingen

De shelve opdracht van het tf opdrachtregelprogramma maakt een back-up van wijzigingen die in behandeling zijn, een lijst met gekoppelde werkitems, notities bij het inchecken en opmerkingen in een plankenset op de Azure DevOps-server. Een plankenset lijkt veel op een wijzigingenset die niet is doorgevoerd op de server. Net als bij een wijzigingenset kan een plankenset van de server worden opgehaald naar een lokale werkruimte door elke gebruiker die over voldoende machtigingen beschikt.

De rekken zijn een alternatief voor het inchecken van wijzigingen die nog niet voldoende zijn getest. Gebruik de rekken als u uw werk wilt onderbreken om het volgende te doen:

  • Deel een set lokale werkbestanden met een andere ontwikkelaar of tester zonder uw wijzigingen in de versiebeheerserver in te checken.

  • U kunt een groep wijzigingen die in behandeling zijn tijdelijk opzij zetten zonder ze in te checken, zodat u in plaats daarvan kunt werken aan een probleem met een hogere prioriteit. Nadat u aan de taak met hoge prioriteit hebt gewerkt, kunt u de ingerichte wijzigingen herstellen met behulp van de opdracht Unshelve.

Als u de optie /move opneemt, wordt met de opdracht shelve elke revisie van het bestand in de basiswerkruimte teruggezet die de laatste versie is die van de server naar de huidige werkruimte is opgehaald. Met name voor alle items die u op de plank hebt, kunt u de optie /move:

  • Gebruikt Undo om de wijzigingen die op de plank zijn opgeslagen ongedaan te maken. De bestanden die in behandeling waren, worden verwijderd uit de werkruimte.

  • Haalt de basiswerkruimteversies op van alle bestanden waarvoor in behandeling zijnde edities van de server bestaan in de huidige werkruimte.

  • Hiermee markeert u alle items in de huidige werkruimte met het kenmerk Alleen-lezen.

Als u de optie /delete opneemt, verwijdert TFVC de opgegeven plankenset definitief van de Azure DevOps-server.

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

Voorbeelden

In het volgende voorbeeld wordt een nieuwe plankenset gemaakt op de Azure DevOps-server met de naam Reflector_BuddyTest, wordt het eigendom toegewezen aan de gebruiker Pat, worden alle items in de huidige werkruimte geretourneerd naar de nieuwste versie die tijdens de laatste get bewerking is gedownload en wordt de status Alleen-lezen ingesteld:

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

In het volgende voorbeeld verwijdert u de bestaande plankenset new-feature van de server, maakt u een nieuwe plankenset op basis van die naam en behoudt u alle wijzigingen die in behandeling zijn in de huidige werkruimte:

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

In het volgende voorbeeld wordt een plankenset gemaakt met de naam HelloWorld_TestMe die alle wijzigingen in behandeling bevat voor alle .cs bestanden in de C:\projects werkmap en de bijbehorende submappen:

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

In het volgende voorbeeld wordt de HelloWorld_24 plankenset verwijderd:

c:\projects> tf shelve HelloWorld_24 /delete