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 wordt een set wijzigingen opgeslagen die in behandeling zijn, samen met in behandeling zijnde inchecknotities, een opmerking en een lijst met gekoppelde werkitems op een Azure DevOps-server zonder ze daadwerkelijk in te checken.

Vereisten

Als u de shelve opdracht wilt gebruiken om een plankenset te verwijderen, moet u eigenaar van een plankenset zijn of moet de machtiging voor Beheer ister wijzigingen zijn ingesteld op Toestaan. Zie Standaard TFVC-machtigingen voor 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 functioneert voor meer informatie over hoe Team Foundation de itemspec items 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 owner, maar alleen als /replace dit ook is opgegeven, opgeven.

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 /login optie. U kunt een gebruikersnaamwaarde opgeven als of DOMAIN\usernameusername.
<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 het dialoogvenster Inchecken van Visual Studio, de opmerking, gekoppelde werkitems, check-innotities en reden voor het negeren van het inchecken van beleid, worden opgeslagen op uw ontwikkelcomputer als wijzigingen die in behandeling zijn totdat u ze hebt ingecheckt. Met /new de optie worden deze incheckmetagegevens 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 /noprompt optie niet opneemt, wordt er een bevestigingsbericht weergegeven wanneer de /delete optie 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 submappen en alle items daarin als u itemspec een map opgeeft.
/noprompt Onderdrukt eventuele aanwijzingen voor invoer van u.
/validate Met deze optie selecteert u het selectievakje Beleidsregels evalueren en inchecknotities voordat u het selectievakje in de rekken - Bronbestanden opent wanneer het wordt geopend. 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

Met shelve de opdracht van het tf opdrachtregelprogramma wordt een back-up gemaakt van wijzigingen die in behandeling zijn, een lijst met gekoppelde werkitems, in-voortgangscontrolenotities 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 wijzigingen op de plank herstellen met behulp van de opdracht Opheffen.

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

  • Hiermee Undo maakt u de wijzigingen ongedaan die zijn opgeslagen. 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 /delete optie opneemt, verwijdert TFVC de opgegeven plankenset definitief van de Azure DevOps-server.

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

Voorbeelden

In het volgende voorbeeld wordt een nieuwe plankenset gemaakt op de Azure DevOps-server met de naam Reflector_BuddyTest, wordt 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 wordt de bestaande plankenset new-feature van de server verwijderd, wordt een nieuwe plankenset gemaakt op basis van die naam en blijven alle wijzigingen in behandeling in de huidige werkruimte behouden:

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

In het volgende voorbeeld wordt een plankenset HelloWorld_TestMe gemaakt met alle in behandeling zijnde wijzigingen in alle .cs bestanden in de werkmap C:\projects 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