Delen via

Opdracht Vergrendelen (Team Foundation Version Control)

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

De TfVC-opdracht (Team Foundation Version Control) lock opdracht 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.

Voorwaarden

Categorie Requirements
toestemmingen - Vergrendelingsmachtigingen ingesteld op Toestaan.
- Ontgrendel de machtigingenset voor wijzigingen van andere gebruikers op Toestaan als u geen schrijfmachtiging hebt voor de werkruimte van een gebruiker die is vergrendeld.

Zie standaard TFVC-machtigingenvoor 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 itemspecwerkt voor meer informatie over hoe TFVC de 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 optie /workspace.

<username>

Biedt een waarde voor de optie /login. U kunt een username-waarde opgeven als DOMAIN\username of 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 Inzicht in vergrendelingstypenvoor 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 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 tfvoor meer informatie over het gebruik van het opdrachtregelprogramma .

Een item vergrendelen

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

Voor add en branchwordt de vergrendeling op de naamruimte geplaatst waar het nieuwe item wordt gemaakt. Vergrendelingen die met rename worden geplaatst, zijn zowel van toepassing op de oude als de nieuwe naamruimten. Zie Mappen of bestanden vergrendelen en ontgrendelenvoor 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 vergrendelingenvoor meer informatie over het toepassen van een uitcheckvergrendeling en wanneer u een incheckvergrendeling toepast.

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 een vergrendeling wijziging toegevoegd aan de set in behandeling zijnde werkruimtewijzigingen. In tegenstelling tot de opdracht checkout, maakt lock een bestand niet automatisch bewerkbaar.

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 optie none. 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.csuitchecken.

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 $/src TFVC-servermap beschikbaar voor uitchecken en inchecken door andere gebruikers.

c:\projects>tf lock /lock:none $/src
  • Last updated on