Label コマンド (Team Foundation バージョン管理)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Team Foundation バージョン管理 (TFVC) の tf label コマンドは、TFVC サーバー内のファイルまたはフォルダーのバージョンに対してラベルのアタッチ、またはラベルの削除を実行します。
前提条件
label コマンドを使用するには、[ラベル] アクセス許可が [許可] に設定されている必要があります。 他のユーザーによって作成されたラベルを変更または削除するには、[ラベルの管理] アクセス許可が [許可] に設定されている必要があります。 詳細については、「既定の TFVC アクセス許可」を参照してください。
構文
tf label labelname[@scope] [/owner:ownername]
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)]
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
tf label /delete labelname[@scope]
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
パラメーター
引数
Argument
説明
<labelname>
指定した項目に対するアタッチ、変更、または削除を実行するラベルの名前を特定します。
@<scope>
labelname が一意である TFVC サーバー ディレクトリを指定します。 このパラメーターを使用すると、同じ名前の 2 つのラベルが TFVC サーバーの異なる部分にあるときに、あるラベルまたはラベル付き項目のセットを独立して作成、管理、取得、および削除できます。
<ownername>
/owner オプションに 対して DOMAIN\JuanGo または単に juango などの値を指定します。
<itemspec>
ラベル付け、再ラベル付け、または変更の元のファイルまたはフォルダーを特定します。 TFVC が itemspec を解析してスコープ内の項目を判別する方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。
注意
複数の itemspec 引数を指定できます。
<versionspec>
/version オプションに c2 などの値を指定します。 TFVC がバージョン指定を解析してそのスコープ内の項目を判別する方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。
<comment>
ラベルについてユーザーが指定したコメント。
@<commentfile>
ラベルに使用するコメントを含む、ディスク上のファイルのユーザー指定のパス。
<username>
/login オプションに値を指定します。 ユーザー名の値は、DOMAIN\username または username の形式で指定できます。
<TeamProjectCollectionUrl>
ラベルをアタッチするかラベルを削除する対象のファイルまたはフォルダーのバージョンを含む、指定したプロジェクト コレクションの URL (例: http://myserver:8080/tfs/DefaultCollection)。
Options
オプション
説明
/owner
ラベルを所有するユーザーの名前を指定します。
/version
省略可能。 ラベルのアタッチ、変更、またはラベルの削除の対象のファイルまたはフォルダーのバージョンを指定します。 これらは変更セット値です (例: C93)。 既定では、versionspec が指定されていない場合、TFVC は基本ワークスペース バージョンを使用します。
/comment
ラベルの説明またはコメントを追加または変更します。
/child
説明なし。
/recursive
itemspec と versionspec に一致するディレクトリ内のすべての項目にラベルを付けます。 /delete オプションと共に使用することはできません。
/delete
ラベルを削除します。
/login
Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。
/collection
プロジェクト コレクションを指定します。
解説
ラベルは、TFVC サーバー内の元々は関連のないファイルとフォルダーのセットにアタッチできるマーカーです。 ラベルを使用して、開発または構築の目的でワークスペースへのファイルとフォルダーの取得を簡素化します。 ラベルは、変更セットや日付/時刻のようなもので、そこに対してファイルやフォルダーの追加および削除を任意に実行したり、その中の項目のバージョンを変更したりできます。 ラベルは、バージョン指定であり、次の TFVC コマンドに渡すことができます。
ラベルの一般的な種類は、M1、Beta2、Release Candidate 0 などのマイルストーン ラベルです。
ラベルはバージョン固有です。 つまり、1 つのラベルをアタッチできるのは、ファイルまたはフォルダーの 1 つのバージョンのみです。 項目の各バージョンは、複数のラベルをサポートできます。
ラベルはバージョン管理されたオブジェクトではありません。 そのため、ファイルのラベル履歴は追跡されません。 また、ラベル操作では、ワークスペースに保留中の変更は作成されません。 label コマンドを発行すると、更新はすぐに TFVC サーバーに反映されます。
tf コマンド ライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。
ラベルを削除する
Unlabel コマンドを使用して、ファイルまたはフォルダーからラベルを削除できます。 別の方法として、tf label /delete コマンドを使用してシステムからラベルを削除できます。
ラベルがアタッチされている項目の一覧、そのコメント、スコープ、所有者を含む既存のラベルの詳細については、「Labels コマンド」を参照してください。
オーバーロードされたラベルを管理する
ラベル名は、指定したスコープ全体で一意である必要があります。 ラベルを追加すると、指定したか暗黙のスコープでのそのラベル名の使用を予約することになります。 @scope パラメーターの既定値はプロジェクトです (例: $/TeamProject1)。
別のチームまたはユーザーが TFVC サーバーの異なる部分にあるバージョン管理されたファイルのセットに M3 などの共通ラベルを追加した場合は、ルート プロジェクト フォルダーが異なるディレクトリにある限り、プロジェクト内のバージョン管理されたファイルに M3 ラベルを適用できます。 たとえば、"$/math" ディレクトリ内のファイルに M3 というラベルが付いている場合、"$/projects" ディレクトリ内のファイルにも M3 ラベルを適用できます。
ラベルを取得、削除するか、M3 というラベルが付いた項目をその他の方法で管理するには、@scope パラメーターを指定して、操作する M3 ラベルを TFVC に指示する必要があります。
Team Foundation バージョン管理サーバーのルート $/ にラベルを作成するか、特定のフォルダーに対する [ラベル] アクセス許可を調整して、他のユーザーが TFVC サーバーの異なる部分で M3 などのラベルを "オーバーロード" することを防止できます。
例
次の例は、"docs" フォルダーのワークスペース バージョンと、そこに含まれるファイルとフォルダーに goodbuild ラベルをアタッチします。
c:\projects>tf label goodbuild docs /recursive
次の例は、"docs" フォルダーに goodbuild ラベルをアタッチしますが、"docs" フォルダーに含まれるファイルとフォルダーにはしません。
c:\projects>tf label goodbuild docs
次の例は、TFVC サーバーの "314.cs" のバージョン 3 に goodbuild ラベルをアタッチします。
c:\projects>tf label goodbuild /version:3 $/src/314.cs
次の例は、TFVC サーバー内のすべての項目から badbuild ラベルを削除します。
c:\projects>tf label /delete badbuild
次の例では、@ スコープ オプションを使用して "314.cs" にラベルを適用します。
c:\projects>tf label goodbuild@$/TeamProject1 314.cs