Partager via


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 :

  • Aucune

    Supprime un verrou d'un élément.

  • Archivage

    Autorise l'extraction et la modification d'un élément dans tous les espaces de travail, mais empêche les utilisateurs d'archiver les modifications apportées à l'élément à l'extérieur du /workspace spécifié tant que vous n'avez pas libéré explicitement le verrou d'archivage. Si l'élément spécifié est verrouillé dans un autre espace de travail, l'opération de verrouillage échoue.

  • Extraction

    Empêche les utilisateurs d'archiver ou d'extraire les éléments spécifiés tant que vous n'aurez pas libéré le verrouillage. Si des utilisateurs ont verrouillé l'un des éléments spécifiés, ou s'il existe des modifications en attente concernant l'un des éléments, l'opération de verrouillage échoue.

/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.

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)

Checkout et Edit, commandes

Status, commande

Autres ressources

Commandes de l'utilitaire en ligne de commande Tf

Utilisation des verrous du contrôle de version