次の方法で共有

[ラベル] コマンド (Team Foundation バージョン コントロール)

  • [アーティクル]

Azure DevOps Services の |Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Team Foundation Version Control (TFVC) tf label コマンドは、TFVC サーバー内のファイルまたはフォルダーのバージョンにラベルをアタッチするか、そのラベルを削除します。

前提 条件

コマンドを使用するには、ラベル アクセス許可を [許可設定します。 他のユーザーによって作成されたラベルを変更または削除するには、[ラベルの管理] アクセス許可 [を許可] に設定します。 詳細については、「既定の 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]

パラメーター

引数

引数の

説明

<labelname>

指定した項目にアタッチ、変更、または削除するラベルの名前を識別します。

@<scope>

labelname が一意である TFVC サーバー ディレクトリを指定します。 このパラメーターを使用すると、同じ名前の 2 つのラベルが TFVC サーバーの異なる部分にある場合に、1 つのラベルまたはラベル付き項目のセットを個別に作成、管理、取得、および削除できます。

<ownername>

DOMAIN\JuanGo、/owner オプションへの juango などの値を提供します。

<itemspec>

ラベル付け、再ラベル付け、または変更の元となるファイルまたはフォルダーを識別します。 TFVC が itemspec を解析してスコープ内にある項目を特定する方法の詳細については、「Team Foundation バージョン管理コマンド使用する」を参照してください。

手記

複数の itemspec 引数を指定できます。

<versionspec>

/version オプションの c2 などの値を提供します。 TFVC がバージョン仕様を解析してスコープ内にある項目を決定する方法の詳細については、「Team Foundation バージョン管理コマンドを使用する」を参照してください。

<comment>

ラベルに関するユーザー指定のコメント。

@<commentfile>

ラベルに使用するコメントを含むディスク上のファイルのユーザー指定のパス。

<username>

/login オプションに値を提供します。 ユーザー名の値は、DOMAIN\username または usernameとして指定できます。

<TeamProjectCollectionUrl>

ラベルを添付するファイルまたはフォルダーのバージョンを含む指定したプロジェクト コレクションの URL。またはラベルを削除する URL (例: http://myserver:8080/tfs/DefaultCollection)。

オプション

オプションの

説明

/owner

ラベルを所有するユーザーの名前を指定します。

/version

随意。 ラベルの添付、変更、またはラベルの削除元となるファイルまたはフォルダーのバージョンを指定します。 C93など、変更セットの値です。 既定では、versionspec が指定されていない場合、TFVC は基本ワークスペース バージョンを使用します。

/comment

ラベルの説明またはコメントを追加または変更します。

/child

ドキュメントに記載されていません。

/recursive

itemspec と versionspecに一致するディレクトリ内のすべての項目にラベルを付けます。 /delete オプションでは使用できません。

/delete

ラベルを削除します。

/login

Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。

/collection

プロジェクト コレクションを指定します。

備考

ラベルは、TFVC サーバー内の関連のないファイルとフォルダーのセットにアタッチできるマーカーです。 このラベルを使用して、開発またはビルドの目的でワークスペースへのファイルとフォルダーの取得を簡略化します。 ラベルは、変更セットや日付/時刻のようなもので、そこからファイルやフォルダーを任意に追加および削除したり、その中の項目のバージョンを変更したりできます。 ラベルは、次の TFVC コマンドに渡すことができるバージョン仕様です。

ラベルの一般的な種類は、M1、Beta2、Release Candidate 0などのマイルストーン ラベルです。

ラベルはバージョン固有です。 つまり、ファイルまたはフォルダーの 1 つのバージョンにのみラベルを添付できます。 アイテムの各バージョンでは、複数のラベルをサポートできます。

ラベルはバージョン管理されたオブジェクトではありません。 そのため、ファイルのラベル履歴は追跡されません。 また、ラベル操作では、ワークスペースに保留中の変更は作成されません。 label コマンドを発行すると、更新が TFVC サーバーにすぐに反映されます。

tf コマンドライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドを使用する」を参照してください。

ラベルの削除と削除

[ラベルの解除] コマンド を使用して、ファイルまたはフォルダーからラベルを削除できます。 または、tf label /delete コマンドを使用して、システムからラベルを削除することもできます。

ラベルが添付されている項目のリスト、そのコメント、スコープ、所有者を含む既存のラベルについては、「Labels コマンド」を参照してください。

オーバーロードされたラベルを管理する

ラベル名は、指定したスコープ全体で一意である必要があります。 ラベルを追加するときは、指定されたスコープまたは暗黙のスコープで、そのラベル名の使用を予約します。 パラメーターの既定値は、$/TeamProject1など、プロジェクトです。

別のチームまたはユーザーが TFVC サーバーの別の部分にあるバージョン管理されたファイルのセットに M3 などの共通ラベルを追加する場合は、ルート プロジェクト フォルダーが異なるディレクトリにある限り、プロジェクト内のバージョン管理されたファイルに M3 ラベルを適用できます。 たとえば、$/math ディレクトリ内のファイルに M3ラベルが付いている場合は、$/projects ディレクトリ内のファイルに M3 ラベルを適用することもできます。

ラベルを取得、削除、または M3ラベル付き項目を管理するには、@scope パラメーターを指定して、操作するラベル M3 TFVC に指示する必要があります。

Team Foundation バージョン 管理サーバーのルート にラベルを作成するか、特定のフォルダーのラベル アクセス許可を 調整することで、他のユーザーが TFVC サーバーのさまざまな部分で などのラベルを "オーバーロード" できないようにすることができます。

例

次の例では、 ラベルを、フォルダーとそのフォルダー ドキュメントのワークスペース バージョンにアタッチします。

c:\projects>tf label goodbuild docs /recursive

次の例では、goodbuild ラベルを ドキュメント フォルダーにアタッチしますが、ドキュメント フォルダーに含まれているファイルやフォルダーには添付しません。

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