Comando Lock
Blocca o sblocca un file o una cartella per negare o concedere nuovamente agli utenti il diritto di estrarre un elemento e modificarlo in un'area di lavoro diversa oppure di archiviare le modifiche in sospeso di un elemento da un'area di lavoro diversa.
Autorizzazioni necessarie
Per utilizzare il comando lock, è necessario disporre dell'autorizzazione Blocco impostata su Consenti. L'impostazione dell'autorizzazione Sblocca modifiche di altri utenti su Consenti è necessaria per rimuovere un blocco utilizzato da un altro utente se non si dispone dell'autorizzazione di Scrittura per l'area di lavoro di tale utente. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
tf lock itemspec /lock:(none|checkout|checkin)
[/workspace:workspacename] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parametri
Argomento |
Descrizione |
|---|---|
itemspec |
Identifica il file o la cartella da bloccare o sbloccare. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sui parametri itemspecs per determinare gli elementi all'interno dell'ambito, vedere Opzioni della riga di comando. .gif "Nota") Nota
È possibile specificare più di un argomento Itemspec.
|
workspacename |
Valore fornito dall'utente per l'opzione /workspace. |
username |
Fornisce un valore all'opzione /login. È possibile specificare un valore username come DOMINIO\NomeUtente o NomeUtente. |
TeamProjectCollectionUrl |
URL dell'insieme di progetti team contenente il file o la cartella che si desidera bloccare o sbloccare (ad esempio, http://myserver:8080/tfs/DefaultCollection). |
Opzione |
Oggetto di descrizione |
|---|---|
/lock |
Specifica un tipo di blocco o rimuove un blocco da un elemento. Per ulteriori informazioni, vedere Informazioni sui tipi di blocco. Opzioni di blocco:
|
/workspace |
Specifica il nome di un'area di lavoro diversa nel quale applicare il blocco. Per impostazione predefinita, il blocco è applicato nell'area di lavoro corrente. |
/login |
Consente di specificare il nome utente e la password necessari per autenticare l'utente con Visual Studio Team Foundation Server. |
/collection |
Specifica l'insieme di progetti team. |
Note
Utilizzare il comando lock per bloccare temporaneamente la versione di un elemento disponibile nel server Controllo della versione di Team Foundation e archiviare una modifica in sospeso senza dover risolvere eventuali conflitti di unione. Se si desidera impedire in modo definitivo l'accesso a un elemento disponibile nel server Controllo della versione di Team Foundation, è invece necessario utilizzare il Comando Permission.
Nota
Se possibile, a titolo di cortesia, informare i colleghi del team quando si applica un blocco a un elemento, spiegandone i motivi e fornendo una stima dei tempi di rimozione del blocco.
Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.
Blocco di un elemento
Per bloccare un elemento, è possibile utilizzare il comando lock oppure specificare un'opzione di blocco durante il commit di diversi altri comandi dell'utilità della riga di comando tf, tra cui:
Comando Rename (controllo della versione di Team Foundation)
Comando Delete (controllo della versione di Team Foundation)
Se si utilizzano i comandi Add e Branch, il blocco verrà applicato allo spazio dei nomi in cui verrà creato il nuovo elemento. Se si utilizza il comando Rename, i blocchi verranno applicati sia al vecchio che al nuovo spazio dei nomi. Per ulteriori informazioni, vedere Bloccare e sbloccare cartelle o file.
Tipi di blocchi
In Team Foundation vengono forniti due tipi di blocchi: checkin e checkout.
Un blocco check-in è meno restrittivo di un blocco check-out. Quando si applica un blocco check-in, gli utenti possono continuare ad apportare modifiche locali all'elemento in altre aree di lavoro. Non è tuttavia possibile archiviare le modifiche fino a quando non si rimuove esplicitamente il blocco check-in dall'area di lavoro.
Un blocco check-out è più restrittivo di un blocco check-in. Quando si applica un blocco check-out a un file o a una cartella inclusa nel controllo della versione, gli utenti non possono estrarre il file per modificarlo né archiviare modifiche in sospeso preesistenti. Non è possibile acquisire un blocco check-out se per un elemento sono attualmente disponibili modifiche in sospeso.
Per ulteriori informazioni sui casi in cui applicare i blocchi check-out e check-in, vedere Informazioni sui tipi di blocco.
Funzionamento dei blocchi
Se un file è estratto quando viene bloccato, il relativo stato viene modificato in modo da includere il nuovo tipo di blocco. Se i file non sono estratti, viene aggiunta una modifica di tipo blocco all'insieme di modifiche in sospeso dell'area di lavoro. A differenza del comando checkout , il comando lock non consente di rendere un file automaticamente modificabile.
I blocchi sulle cartelle sono ricorsivi in modo implicito. Se si blocca una cartella, non è necessario bloccare i file in essa contenuti a meno che non si desideri applicare il blocco check-out più restrittivo a un file della cartella alla quale è stato applicato il blocco check-in.
Sblocco di un elemento
Per sbloccare un elemento bloccato, è possibile utilizzare l'opzione none . In Team Foundation un elemento viene inoltre bloccato automaticamente quando si archiviano modifiche in sospeso nell'area di lavoro.
Per determinare quali file sono bloccati nel server Controllo della versione di Team Foundation e chi ha applicato il blocco, è possibile utilizzare il Comando Status.
Esempi
L'esempio riportato di seguito impedisce ad altri utenti di estrarre il file 314.cs.
c:\projects>tf lock /lock:checkout 314.cs
L'esempio riportato di seguito impedisce ad altri utenti di archiviare le modifiche nel file 1256.cs, ma di consente di estrarre tale file nelle relative aree di lavoro.
c:\projects>tf lock /lock:checkin 1256.cs
L'esempio riportato di seguito impedisce ad altri utenti di apportare modifiche in sospeso agli eventuali elementi presenti nella cartella src/ del server Controllo della versione di Team Foundation.
c:\projects>tf lock /lock:checkout $/src
L'esempio riportato di seguito consente di sbloccare e rendere tutti i file presenti nella cartella src/ del server Controllo della versione di Team Foundation disponibili per l'estrazione e l'archiviazione da parte di altri utenti.
c:\projects>tf lock /lock:none src/
Vedere anche
Riferimenti
Sintassi della riga di comando (controllo della versione)
Concetti
Informazioni sui tipi di blocco
Configurare il computer di sviluppo per l'utilizzo del progetto del team