Delen via

Opdracht Vergrendelen (Team Foundation Version Control)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

De TFVC-opdracht (Team Foundation Version Control) lock vergrendelt of ontgrendelt een bestand of map. De opdracht weigert of herstelt het recht van gebruikers om een item te uitchecken voor bewerken in een andere werkruimte of om in behandeling zijnde wijzigingen in een item vanuit een andere werkruimte in te checken.

Vereisten

Als u de lock opdracht wilt gebruiken, moet de machtiging Vergrendelen zijn ingesteld op Toestaan. U hebt de machtiging Voor het ontgrendelen van wijzigingen van een andere gebruiker ingesteld op Toestaan om een vergrendeling van een andere gebruiker te verwijderen als u geen schrijfmachtiging hebt voor de werkruimte van die gebruiker. Zie Standaard TFVC-machtigingen voor meer informatie.

Syntaxis

tf lock itemspec /lock:(none|checkout|checkin) 
[/workspace:workspacename] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parameters

Argumenten

Argument

Beschrijving

<itemspec>

Identificeert het bestand of de map die moet worden vergrendeld of ontgrendeld. Zie Opties gebruiken om te wijzigen hoe een opdracht functioneert voor meer informatie over hoe TFVC het itemspec parseert om te bepalen welke items binnen het bereik vallen.

Notitie

U kunt meer dan één itemspec argument opgeven.

<workspacename>

De door de gebruiker opgegeven waarde voor de /workspace optie.

<username>

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

<TeamProjectCollectionUrl>

De URL van de projectverzameling die het bestand of de map bevat die u wilt vergrendelen of ontgrendelen, bijvoorbeeld http://myserver:8080/tfs/DefaultCollection.

Opties

Optie

Beschrijving

/lock

Hiermee geeft u een vergrendelingstype op of verwijdert u een vergrendeling van een item. Zie Vergrendelingstypen begrijpen voor meer informatie.

Vergrendelingsopties:

  • None: Hiermee verwijdert u een vergrendeling van een item.

  • Checkin: Hiermee kan een item worden uitgecheckt en bewerkt in alle werkruimten, maar voorkomt u dat gebruikers wijzigingen in het item buiten de opgegeven /workspace periode inchecken totdat u het inchecken expliciet vrijgeeft. Als het opgegeven item is vergrendeld in een andere werkruimte, mislukt de vergrendelingsbewerking.

  • Checkout: Hiermee voorkomt u dat gebruikers de opgegeven items inchecken of uitchecken totdat u de vergrendeling expliciet loslaat. Als gebruikers een van de opgegeven items hebben vergrendeld of als er wijzigingen in behandeling zijn voor een van de items, mislukt de vergrendelingsbewerking.

/workspace

Hiermee geeft u de naam op van een andere werkruimte waarin de vergrendeling moet worden toegepast. Standaard wordt de vergrendeling toegepast in de werkruimte waarin u zich momenteel bevindt.

/login

Hiermee geeft u de gebruikersnaam en het wachtwoord op om de gebruiker te verifiëren met Azure DevOps.

/collection

Hiermee geeft u de projectverzameling op.

Opmerkingen

U kunt de opdracht Vergrendelen gebruiken om de TFVC-serverversie van een item tijdelijk te blokkeren, zodat u een wijziging in behandeling kunt inchecken zonder samenvoegingsconflicten op te lossen. Als u de toegang tot een item op de TFVC-server permanent wilt voorkomen, moet u in plaats daarvan de opdracht Machtiging gebruiken.

Notitie

Als een beleefdheid aan uw teamleden, informeert u ze wanneer u een vergrendeling toepast op een item, legt u uit waarom u dit doet en schat wanneer u van plan bent om de vergrendeling te verwijderen, indien mogelijk.

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

Een item vergrendelen

U kunt een item vergrendelen met behulp van de lock opdracht of door een lock optie op te geven tijdens de opdracht van verschillende andere tf opdrachtregelprogrammaopdrachten, waaronder:

branchDe add vergrendeling wordt geplaatst op de naamruimte waar het nieuwe item wordt gemaakt. Vergrendelingen die worden geplaatst, rename zijn zowel van toepassing op de oude als de nieuwe naamruimten. Zie Mappen of bestanden vergrendelen en ontgrendelen voor meer informatie.

Vergrendelingstypen

TFVC biedt twee typen vergrendelingen: checkin en checkout.

Een incheckvergrendeling is minder beperkend dan een uitcheckvergrendeling. Wanneer u een incheckvergrendeling toepast, kunnen gebruikers lokale wijzigingen blijven aanbrengen in het item in andere werkruimten. De wijzigingen kunnen pas worden ingecheckt nadat u de incheckvergrendeling expliciet uit de werkruimte hebt verwijderd.

Een uitcheckvergrendeling is restrictiever dan een incheckvergrendeling. Wanneer u een uitcheckvergrendeling toepast op een bestand of map dat door een versie wordt beheerd, kunnen gebruikers het item niet uitchecken voor bewerken of vooraf bestaande wijzigingen in behandeling inchecken. U kunt geen uitcheckvergrendeling verkrijgen als er momenteel wijzigingen in behandeling zijn in een item.

Zie Inzicht in vergrendelingstypen voor meer informatie over wanneer u een uitcheckvergrendeling toepast en wanneer u een incheckvergrendeling wilt toepassen.

Hoe vergrendelen werkt

Als u een bestand hebt uitgecheckt wanneer u het vergrendelt, wordt de status gewijzigd zodat het nieuwe vergrendelingstype wordt weergegeven. Als de bestanden niet zijn uitgecheckt, wordt er een vergrendelingswijziging toegevoegd aan de set wijzigingen in de werkruimte die in behandeling zijn. In tegenstelling tot de checkout opdracht wordt lock een bestand niet automatisch bewerkt.

Vergrendelingen op mappen zijn impliciet recursief. Als u een map vergrendelt, hoeft u de bestanden die deze bevat niet te vergrendelen, tenzij u de meer beperkende check-outvergrendeling wilt toepassen op een bestand in een map met een incheckvergrendeling.

Een item ontgrendelen

U kunt een vergrendeld item ontgrendelen met behulp van de none optie. TFVC ontgrendelt ook automatisch een item wanneer u in behandeling zijnde wijzigingen in de werkruimte incheckt.

U kunt bepalen welke bestanden zijn vergrendeld op de TFVC-server en door wie de bestanden zijn vergrendeld met behulp van de opdracht Status.

Voorbeelden

In het volgende voorbeeld voorkomt u dat andere gebruikers 314.cs uitchecken.

c:\projects>tf lock /lock:checkout 314.cs

In het volgende voorbeeld voorkomt u dat andere gebruikers wijzigingen in 1256.cs inchecken, maar kunnen ze deze uitchecken in hun werkruimten.

c:\projects>tf lock /lock:checkin 1256.cs

In het volgende voorbeeld voorkomt u dat andere gebruikers wijzigingen in behandeling hebben in items in de map $/src op de TFVC-server.

c:\projects>tf lock /lock:checkout $/src

Het volgende voorbeeld ontgrendelt en maakt alle bestanden in de map $/src TFVC-server beschikbaar voor uitchecken en inchecken door andere gebruikers.

c:\projects>tf lock /lock:none $/src