Comando Lock (controllo della versione di Team Foundation)

  • Articolo

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

Visual Studio 2019 | Visual Studio 2022

Il comando controllo della versione di Team Foundation (TFVC) lock blocca o sblocca un file o una cartella. Il comando nega o ripristina il diritto degli utenti di controllare un elemento per la modifica in un'area di lavoro diversa o di archiviare le modifiche in sospeso in un elemento da un'area di lavoro diversa.

Prerequisiti

Per usare il lock comando, è necessario avere l'autorizzazione Lock impostata su Consenti. È necessaria l'autorizzazione Sblocca modifiche di un altro utente su Consenti di rimuovere un blocco mantenuto da un altro utente se non si dispone dell'autorizzazione di scrittura per l'area di lavoro dell'utente. Per altre informazioni, vedere Autorizzazioni tfvc predefinite.

Sintassi

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

Parametri

Argomenti

Argomento

Descrizione

<itemspec>

Identifica il file o la cartella da bloccare o sbloccare. Per altre informazioni sul modo in cui TFVC analizza itemspec per determinare quali elementi si trovano nell'ambito, vedere Usare le opzioni per modificare il modo in cui un comando funziona.

Nota

È possibile specificare più itemspec argomenti.

<workspacename>

Valore fornito dall'utente per l'opzione /workspace .

<username>

Fornisce un valore all'opzione /login . È possibile specificare un username valore come DOMAIN\username o username.

<TeamProjectCollectionUrl>

URL della raccolta di progetti che contiene il file o la cartella che si desidera bloccare o sbloccare, ad esempio http://myserver:8080/tfs/DefaultCollection.

Opzioni

Opzione

Descrizione

/lock

Specifica un tipo di blocco o rimuove un blocco da un elemento. Per altre informazioni, vedere Informazioni sui tipi di blocco.

Opzioni di blocco:

  • None: rimuove un blocco da un elemento.

  • Checkin: consente di archiviare e modificare un elemento in tutte le aree di lavoro, ma impedisce agli utenti di archiviare le modifiche all'elemento all'esterno dell'oggetto specificato /workspace fino a quando non si rilascia in modo esplicito il blocco di archiviazione. Se l'elemento specificato è bloccato in qualsiasi altra area di lavoro, l'operazione di blocco ha esito negativo.

  • Checkout: impedisce agli utenti di eseguire l'archiviazione o l'estrazione degli elementi specificati fino a quando non si rilascia in modo esplicito il blocco. Se gli utenti hanno bloccato uno degli elementi specificati o se sono presenti modifiche in sospeso rispetto a uno degli elementi, l'operazione di blocco ha esito negativo.

/workspace

Specifica il nome di un'area di lavoro diversa in cui applicare il blocco. Per impostazione predefinita, il blocco viene applicato nell'area di lavoro in cui si è attualmente.

/login

Specifica il nome utente e la password per autenticare l'utente con Azure DevOps.

/collection

Specifica la raccolta di progetti.

Osservazioni:

È possibile usare il comando lock per bloccare temporaneamente la versione del server TFVC di un elemento in modo da poter archiviare una modifica in sospeso senza dover risolvere eventuali conflitti di merge. Se si vuole impedire in modo permanente l'accesso a un elemento nel server TFVC, usare invece il comando Permission .

Nota

Per gentile concessione ai tuoi compagni di squadra, avvisali quando applichi un blocco a un elemento, spiega perché stai facendo questo e stima quando prevedi di rimuovere il blocco, se possibile.

Per altre informazioni su come usare l'utilità della tf riga di comando, vedere Usare i comandi di controllo della versione di Team Foundation.

Come bloccare un elemento

È possibile bloccare un elemento usando il lock comando o specificando un'opzione lock durante la commissione di diversi altri tf comandi dell'utilità della riga di comando, tra cui:

Per add e branch, il blocco viene inserito nello spazio dei nomi in cui verrà creato il nuovo elemento. I blocchi posizionati con rename si applicano sia agli spazi dei nomi vecchi che ai nuovi spazi dei nomi. Per altre informazioni, vedere Bloccare e sbloccare cartelle o file.

Tipi di blocco

TFVC offre due tipi di blocchi: checkin e checkout.

Un blocco di archiviazione è meno restrittivo di un blocco di estrazione. Quando si applica un blocco di archiviazione, gli utenti possono continuare a apportare modifiche locali all'elemento in altre aree di lavoro. Le modifiche non possono essere archiviate finché non si rimuove esplicitamente il blocco di archiviazione dall'area di lavoro.

Un blocco di estrazione è più restrittivo di un blocco di archiviazione. Quando si applica un blocco di estrazione a un file o a una cartella controllata dalla versione, gli utenti non possono estrarlo né archiviare le modifiche preesistenti in sospeso. Non è possibile acquisire un blocco di estrazione se sono attualmente presenti modifiche in sospeso a un elemento.

Per altre informazioni su quando applicare un blocco di estrazione e quando applicare un blocco di archiviazione, vedere Informazioni sui tipi di blocco.

Funzionamento del blocco

Se è stato estratto un file quando lo si blocca, il relativo stato viene modificato in modo da contenere il nuovo tipo di blocco. Se i file non vengono estratti, viene aggiunta una modifica di blocco al set di modifiche dell'area di lavoro in sospeso. A differenza del checkout comando, lock non rende automaticamente modificabile un file.

I blocchi sulle cartelle sono ricorsivi in modo implicito. Se si blocca una cartella, non è necessario bloccare i file contenuti, a meno che non si voglia applicare il blocco di estrazione più restrittivo a un file in una cartella con un blocco di archiviazione.

Sbloccare un elemento

È possibile sbloccare un elemento bloccato usando l'opzione none . TFVC sblocca anche automaticamente un elemento quando si controllano le modifiche in sospeso nell'area di lavoro.

È possibile determinare quali file sono bloccati nel server TFVC e da quali file sono stati bloccati usando il comando Stato.

Esempi

Nell'esempio seguente viene impedito ad altri utenti di estrarne 314.cs.

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

L'esempio seguente impedisce ad altri utenti di archiviare le modifiche apportate a 1256.cs , ma consente di estrarlo nelle aree di lavoro.

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

Nell'esempio seguente viene impedito ad altri utenti di modificare gli elementi nella cartella $/src nel server TFVC.

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

Nell'esempio seguente vengono sbloccati e resi disponibili tutti i file nella cartella del server $/src TFVC per l'estrazione e l'archiviazione da parte di altri utenti.

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