Sdílet prostřednictvím

Příkaz Lock (Správa verzí Team Foundation)

  • Článek

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

Visual Studio 2019 | Visual Studio 2022

Správa verzí Team Foundation (TFVC) lock příkaz uzamkne nebo odemkne soubor nebo složku. Příkaz odepře nebo obnoví právo uživatelů rezervovat položku pro úpravy do jiného pracovního prostoru nebo vrátit se změnami čekající změny položky z jiného pracovního prostoru.

Požadavky

Pokud chcete použít příkaz lock, nastavte oprávnění Lock na Povolit. Potřebujete Odemknout změny jiného uživatele, oprávnění nastavená na Povolit odebrat zámek uchovávaný jiným uživatelem, pokud nemáte oprávnění k zápisu pro pracovní prostor daného uživatele. Další informace najdete v tématu Výchozí oprávnění TFVC.

Syntax

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

Parametry

Argumenty

argumentu

popis

<itemspec>

Identifikuje soubor nebo složku k uzamčení nebo odemknutí. Další informace o tom, jak TFVC parsuje itemspec určit, které položky jsou v oboru, najdete v tématu Použití možností k úpravě způsobu fungování příkazů.

Poznámka

Můžete zadat více než jeden itemspec argument.

<workspacename>

Hodnota zadaná uživatelem pro možnost /workspace.

<username>

Poskytuje hodnotu /login možnosti. Hodnotu username můžete zadat buď jako DOMAIN\username, nebo username.

<TeamProjectCollectionUrl>

Adresa URL kolekce projektů, která obsahuje soubor nebo složku, kterou chcete zamknout nebo odemknout, například http://myserver:8080/tfs/DefaultCollection.

Volby

možnost

popis

/lock

Určuje typ zámku nebo odebere zámek z položky. Další informace najdete v tématu Principy typů zámků.

Možnosti uzamčení:

  • None: Odebere zámek z položky.

  • Checkin: Umožňuje rezervaci a úpravu položky ve všech pracovních prostorech, ale zabrání uživatelům vrátit se změnami položky mimo zadanou /workspace, dokud explicitně nezaškrtnete zámek vrácení se změnami. Pokud je zadaná položka uzamčena v jiném pracovním prostoru, operace uzamčení selže.

  • Checkout: Zabrání uživatelům v vrácení se sem nebo rezervaci zadaných položek, dokud zámek explicitně neuvolníte. Pokud uživatelé zamkli některou ze zadaných položek nebo pokud existují čekající změny u některé z položek, operace uzamčení selže.

/workspace

Určuje název jiného pracovního prostoru, ve kterém se má zámek použít. Ve výchozím nastavení se zámek použije v pracovním prostoru, ve kterém právě jste.

/login

Určuje uživatelské jméno a heslo pro ověření uživatele pomocí Azure DevOps.

/collection

Určuje kolekci projektů.

Poznámky

Pomocí příkazu lock můžete dočasně ukotvit verzi serveru TFVC položky, abyste mohli vrátit se změnami čekající změnu, aniž byste museli řešit konflikty při sloučení. Pokud chcete trvale zabránit přístupu k položce na serveru TFVC, měli byste místo toho použít příkaz Oprávnění.

Poznámka

Jako zdvořilost pro členy týmu je informujte, když u položky použijete zámek, vysvětlete, proč to děláte, a odhadněte, kdy chcete zámek odebrat, pokud je to možné.

Další informace o použití nástroje příkazového řádku tf naleznete v tématu Použití příkazů správy verzí Team Foundation.

Jak zamknout položku

Položku můžete uzamknout pomocí příkazu lock nebo zadáním možnosti lock během provizí několika dalších příkazů příkazového řádku tf, mezi které patří:

Pro add a branchse zámek umístí do oboru názvů, kde se vytvoří nová položka. Zámky umístěné se rename aplikují na staré i nové obory názvů. Další informace najdete v tématu Uzamčení a odemknutí složek nebo souborů.

Typy zámků

TFVC poskytuje dva typy zámků: checkin a checkout.

Zámek vrácení se změnami je méně omezující než uzamčení rezervace. Když použijete zámek vrácení se změnami, můžou uživatelé pokračovat v provádění místních změn položky v jiných pracovních prostorech. Změny nelze vrátit se změnami, dokud z pracovního prostoru explicitně neodeberete zámek vrácení se změnami.

Zámek rezervace je více omezující než zámek vrácení se změnami. Když u souboru nebo složky řízené verzí použijete zámek rezervace, uživatelé nemůžou rezervovat položku pro úpravy ani vrátit se změnami před existující čekající změny. Zámek rezervace není možné získat, pokud v současné době nejsou k dispozici žádné čekající změny položky.

Další informace o tom, kdy použít uzamčení rezervace a kdy použít zámek vrácení se změnami, najdete v tématu Vysvětlení typů zámků.

Jak funguje uzamykání

Pokud máte soubor rezervovaný, když ho zamknete, změní se jeho stav tak, aby obsahoval nový typ zámku. Pokud soubory nejsou rezervované, přidá se do sady čekajících změn pracovního prostoru zámek. Na rozdíl od příkazu checkoutlock automaticky neupravuje soubor.

Zámky u složek jsou implicitně rekurzivní. Pokud zamknete složku, nemusíte zamknout soubory, které obsahuje, pokud nechcete použít přísnější zámek rezervace u souboru ve složce, která má zámek vrácení se změnami.

Odemknutí položky

Uzamčenou položku můžete odemknout pomocí možnosti none. TFVC také automaticky odemkne položku, když v pracovním prostoru zrušíte čekající změny.

Pomocípříkazu Stav můžete určit, které soubory jsou zamknuté na serveru TFVC a kým byly soubory uzamčeny.

Příklady

Následující příklad zabraňuje ostatním uživatelům v rezervaci 314.cs.

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

Následující příklad brání ostatním uživatelům v vrácení změn do 1256.cs, ale umožňuje jim ho rezervovat ve svých pracovních prostorech.

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

Následující příklad zabrání ostatním uživatelům v čekajících změnách všech položek ve složce $/src na serveru TFVC.

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

Následující příklad odemkne a zpřístupní všechny soubory ve složce serveru $/src TFVC pro rezervace a vrácení se změnami jinými uživateli.

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