Lock コマンド
更新 : 2007 年 11 月
項目をチェックアウトして別のワークスペースで編集するためのユーザー権利、または別のワークスペースから保留中の変更を項目にチェックインするためのユーザー権利を拒否および復元するためにファイルまたはフォルダをロックまたはアンロックします。
必要なアクセス許可
lock コマンドを使用するには、[ロック] のアクセス許可が [許可] に設定されている必要があります。別のユーザーが設定したロックを解除する必要があるが、そのユーザーのワークスペースに対する [書き込み] のアクセス許可がない場合は、[他のユーザーの変更のロック解除] のアクセス許可が [許可] に設定されている必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。
tf lock itemspec /lock:(none|checkout|checkin)
[/workspace:workspacename] [/server:servername] [/recursive]
パラメータ
引数 |
説明 |
|---|---|
itemspec |
ロックまたはアンロックするファイルまたはフォルダを指定します。Team Foundation で itemspecs を解析してスコープ内にある項目を確認する方法の詳細については、「コマンド ライン オプション」を参照してください。 |
workspacename |
/workspace オプションにユーザーが指定した値。 |
servername |
/server オプションにユーザーが指定した値。例: http://teamfoundation2:8080/。 |
オプション |
説明 |
|---|---|
/lock |
ロックの種類を指定するか、項目からロックを削除します。詳細については、「ロックの種類について」を参照してください。 ロック オプション:
|
/workspace |
ロックを適用する別のワークスペースの名前を指定します。ロックは、既定で、現在使用しているワークスペースに適用されます。 |
/server |
操作する Team Foundation バージョン管理 サーバーの URL を指定します。ワークスペースに割り当てられていないディレクトリからコマンドを呼び出す場合は、このオプションを指定する必要があります。 |
解説
ロック コマンドを使用すると、項目の Team Foundation バージョン管理 サーバー バージョンを一時的に固定できるので、保留中の変更をチェックインする際にマージの競合を解決する必要がありません。Team Foundation バージョン管理 サーバーの項目へのアクセスを永続的に禁止する場合は、代わりに Permission コマンドを使用します。
.gif "メモ") メモ : |
|---|
項目をロックするときは、チーム メンバにロックする理由およびロックを削除する時期を説明する通知を送信します。 |
tf コマンド ライン ユーティリティの使い方の詳細については、「Tf コマンド ライン ユーティリティのコマンド」を参照してください。
項目をロックする方法
項目をロックするには、ロック コマンドを使用するか、または次のような tf コマンド ライン ユーティリティの他のコマンドの実行中にロック オプションを指定します。
Add と Branch コマンドでは、ロックは新しい項目が作成される名前空間に適用されます。Rename コマンドと共に使用するロックは、古い名前空間と新しい名前空間の両方に適用されます。詳細については、「方法 : フォルダまたはファイルをロックおよびアンロックする」を参照してください。
ロックの種類
Team Foundation には、checkin と checkout の 2 種類のロックがあります。
チェックイン ロックは、チェックアウト ロックほど制限が強力ではありません。チェックイン ロックを適用すると、ユーザーは引き続き他のワークスペースで項目をローカルに変更できます。変更は、ワークスペースからチェックイン ロックが明示的に削除されるまでチェックインできません。
チェックアウト ロックは、チェックイン ロックより制限が強力です。チェックアウト ロックをバージョン管理されたファイルまたはフォルダに適用すると、ユーザーはファイルをチェックアウトして編集することも、既存の保留中の変更をチェックインすることもできません。項目に対する保留中の変更がある場合、チェックアウト ロックを適用することはできません。
チェックイン ロックとチェックアウト ロックを適用する時期の詳細については、「ロックの種類について」を参照してください。
ロックの動作
チェックアウトされているファイルをロックする場合、状態は新しいロックの種類を追加して変更されます。ファイルがチェックアウトされていない場合、"ロック" の変更はワークスペースの保留中の変更セットに追加されます。lock コマンドでは、checkout コマンドと異なり、ファイルは自動的に編集可能になりません。
フォルダのロックは暗黙的に再帰的です。フォルダをロックする場合、ファイルに制限が強いチェックアウト ロックを適用する場合を除いて、チェックイン ロックが適用されているフォルダに含まれるファイルをロックする必要はありません。
項目のロックの解除
ロックされた項目は、none オプションを使用してロックを解除できます。さらに、Team Foundation では、ワークスペースで保留中の変更をチェックインすると、項目は自動的にアンロックされます。
Status コマンドを使用すると、Team Foundation バージョン管理 サーバーでロックされているファイル、およびロックしたユーザーを確認できます。
例
次の例は、他のユーザーが 314.cs をチェックアウトできないようにします。
c:\projects>tf lock /lock:checkout 314.cs
次の例は、他のユーザーが 1256.cs への変更をチェックインできないようにし、各自のワークスペースへのチェックアウトはできるようにします。
c:\projects>tf lock /lock:checkin 1256.cs
次の例は、他のユーザーが Team Foundation バージョン管理 サーバーの src/ フォルダのすべての項目に対する変更を保留できないようにします。
c:\projects>tf lock /lock:checkout $/src
次の例は、Team Foundation バージョン管理 サーバーの src/ フォルダのすべてのファイルのロックを解除して、他のユーザーがチェックアウトおよびチェックインできるようにします。
c:\projects>tf lock /lock:none src/