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

  • Článek

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

Visual Studio 2019 | Visual Studio 2022

Příkaz Správa verzí Team Foundation (TFVC) lock 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 příkaz použít lock , musíte mít oprávnění Lock nastaveno na Povolit. Pokud nemáte oprávnění k zápisu pro pracovní prostor daného uživatele, potřebujete oprávnění Odemknout změny jiného uživatele nastavené na Možnost Povolit odebrat zámek uložený jiným uživatelem. Další informace naleznete v tématu Výchozí oprávnění TFVC.

Syntaxe

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

Parametry

Argumenty

Argument

Popis

<itemspec>

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

Poznámka:

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

<workspacename>

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

<username>

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

<TeamProjectCollectionUrl>

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

Možnosti

Možnost

Popis

/lock

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

Možnosti uzamčení:

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

  • Checkin: Umožňuje rezervovat a upravit položku ve všech pracovních prostorech, ale zabrání uživatelům vrátit se změnami položky mimo zadanou /workspace položku, dokud explicitně neuvolníte 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í 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 tom, jak používat nástroj příkazového tf řádku, naleznete v tématu Použití příkazů správy verzí Team Foundation.

Jak zamknout položku

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

branchZámek add se umístí do oboru názvů, kde se vytvoří nová položka. Zámky umístěné rename s použitím starých i nových oborů 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 zámek 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 změna zámku . checkout Na rozdíl od příkazu lock se soubor automaticky neupravuje.

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í této none možnosti. 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 uzamčené na serveru TFVC a podle kterých byly soubory uzamčeny.

Příklady

Následující příklad brání 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 je rezervovat ve svých pracovních prostorech.

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

Následující příklad zabraňuje 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