Lock, commande
Mise à jour : novembre 2007
Verrouille ou déverrouille un fichier ou un dossier pour refuser ou restaurer aux utilisateurs le droit d'extraire un élément en vue de le modifier dans un espace de travail différent ou d'archiver les modifications en attente apportées à un élément provenant d'un espace de travail différent.
Autorisations requises
Pour utiliser la commande lock, vous devez disposer de l'autorisation Verrouiller avec la valeur Autoriser. L'autorisation Déverrouiller les modifications des autres utilisateurs doit avoir la valeur Autoriser pour qu'il soit possible de supprimer un verrou maintenu par un autre utilisateur si vous ne disposez pas de l'autorisation Écrire pour l'espace de travail de cet utilisateur. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf lock itemspec /lock:(none|checkout|checkin)
[/workspace:workspacename] [/server:servername] [/recursive]
Paramètres
Argument |
Description |
|---|---|
itemspec |
Identifie le fichier ou le dossier à verrouiller ou déverrouiller. Pour plus d'informations sur la façon dont Team Foundation analyse les spécifications d'éléments (itemspecs) afin de déterminer quels éléments se trouvent dans la portée, consultez Options de ligne de commande. |
workspacename |
Valeur fournie par l'utilisateur pour l'option /workspace. |
servername |
Valeur fournie par l'utilisateur pour l'option /server. Exemple : http://teamfoundation2:8080/. |
Option |
Description |
|---|---|
/lock |
Spécifie un type de verrou ou supprime un verrou d'un élément. Pour plus d'informations, consultez Présentation des types de verrous. Options de verrouillage :
|
/workspace |
Spécifie le nom d'un espace de travail différent dans lequel appliquer le verrouillage. Par défaut, le verrouillage est appliqué dans l'espace de travail dans lequel vous vous trouvez actuellement. |
/server |
Spécifie l'URL du serveur de contrôle de version Team Foundation dans lequel travailler. Cette option est requise si la commande est appelée depuis un répertoire non mappé à un espace de travail. |
Notes
Vous pouvez utiliser la commande de verrouillage pour figer temporairement la version d'un élément sur le serveur de contrôle de version Team Foundation afin d'archiver une modification en attente sans être obligé de résoudre des conflits de fusion. Si vous souhaitez empêcher définitivement l'accès à un élément du serveur de contrôle de version Team Foundation, vous devez plutôt utiliser la Permission, commande.
.gif "Remarque") Remarque : |
|---|
Par égard envers vos coéquipiers, informez-les lorsque vous appliquez un verrouillage à un élément, expliquez-en la raison et tâchez d'évaluer, si possible, le moment ou vous pensez pouvoir supprimer le verrouillage. |
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Comment verrouiller un élément
Vous pouvez verrouiller un élément à l'aide de la commande de verrouillage ou en spécifiant une option de verrouillage lors de la mise en service de plusieurs autres commandes de l'utilitaire en ligne de commande tf qui comprend :
Pour les fonctions d'ajout et de création de branche, le verrouillage est placé sur l'espace de noms dans lequel le nouvel élément sera créé. Les verrous placés avec un nouveau nom s'appliquent à la fois aux anciens et aux nouveaux espaces de noms. Pour plus d'informations, consultez Comment : verrouiller et déverrouiller des dossiers ou des fichiers.
Types de verrouillage
Team Foundation fournit deux types de verrouillages : checkin et checkout.
Un verrou d'archivage est moins restrictif qu'un verrou d'extraction. Lorsque vous appliquez un verrou d'archivage, les utilisateurs peuvent continuer à apporter des modifications locales à l'élément dans d'autres espaces de travail. Les modifications ne peuvent pas être archivées tant que vous n'avez pas supprimé explicitement le verrou d'archivage de l'espace de travail.
Un verrou d'extraction est plus restrictif qu'un verrou d'archivage. Lorsque vous appliquez un verrou d'extraction à un fichier ou un dossier sous contrôle de version, les utilisateurs ne peuvent ni extraire le fichier pour le modifier ni archiver les modifications préexistantes en attente. Vous ne pouvez pas acquérir de verrou d'extraction si un élément est actuellement soumis à des modifications en attente.
Pour plus d'informations afin de savoir quand appliquer un verrou d'extraction et quand appliquer un verrou d'archivage, consultez Présentation des types de verrous.
Comment fonctionne le verrouillage
Si un fichier est extrait au moment où vous le verrouillez, son état est modifié pour contenir le nouveau type de verrouillage. Si les fichiers ne sont pas extraits, une modification de " verrouillage " est ajoutée au jeu de modifications de l'espace de travail en attente. Contrairement à la commande checkout , lock ne rend pas automatiquement le fichier modifiable.
Les verrouillages sur les dossiers sont implicitement récursifs. Si vous verrouillez un dossier, vous n'êtes pas tenu de verrouiller les fichiers qu'il contient à moins que vous ne souhaitiez appliquer le verrou d'extraction, plus restrictif, à un fichier situé dans un dossier pourvu d'un verrou d'archivage.
Déverrouiller un élément
Vous pouvez déverrouiller un élément verrouillé à l'aide de l'option none . En outre, Team Foundation déverrouille automatiquement un élément lorsque vous archivez des modifications en attente dans l'espace de travail.
Vous devez déterminer les fichiers verrouillés sur le serveur de contrôle de version Team Foundation et l'utilisateur qui les a verrouillés à l'aide de la Status, commande.
Exemples
L'exemple suivant empêche les autres utilisateurs d'extraire 314.cs.
c:\projects>tf lock /lock:checkout 314.cs
L'exemple suivant empêche les autres utilisateurs d'archiver les modifications apportées à 1256.cs, mais leur permet de l'extraire dans leur espace de travail.
c:\projects>tf lock /lock:checkin 1256.cs
L'exemple suivant empêche les autres utilisateurs de placer des modifications en attente sur les éléments du dossier src/ situé sur le serveur de contrôle de version Team Foundation.
c:\projects>tf lock /lock:checkout $/src
L'exemple suivant déverrouille et rend tous les fichiers du dossier src/ du serveur de contrôle de version Team Foundation accessibles à d'autres utilisateurs pour extraction et archivage.
c:\projects>tf lock /lock:none src/
Voir aussi
Concepts
Présentation des types de verrous
Utilisation des espaces de travail du contrôle de version
Référence
Syntaxe de ligne de commande (Team System)