Labels コマンド (Team Foundation バージョン管理)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2022

Team Foundation バージョン管理 (TFVC) の tf labels コマンドは、TFVC サーバー内のラベルのリストを表示します。

前提条件

labels コマンドを使用するには、指定したラベルがアタッチされているすべてのファイルまたはフォルダーに対する [読み取り] アクセス許可が [許可] に設定されている必要があります。 ラベルで参照されているすべてのファイルではなく、一部のファイルに対するアクセス許可がある場合は、部分的な結果が表示されます。 詳細については、「既定の TFVC アクセス許可」を参照してください。

構文

tf labels [/owner:ownername] [/format:(brief|detailed)] 
[/collection:TeamProjectCollectionUrl] [labelname] [/login:username,[password]]

パラメーター

引数

Argument

説明

<ownername>

/owner オプションに 対して DOMAIN\JuanGo または単に juango などの値を指定します。

<labelname>

ラベルの一覧をフィルター処理するために使用する文字列を指定します。 このパラメーターを省略すると、ラベル名フィールドはフィルター処理されません。

<TeamProjectCollectionUrl>

ラベルの一覧を表示するプロジェクト コレクションの URL (例: http://myserver:8080/tfs/DefaultCollection)。

<username>

/login オプションに値を指定します。 username 値は、DOMAIN\username または username として指定できます。

Options

オプション

説明

/owner

ラベルを所有するユーザーの名前を指定します。 既定では、所有者はラベルを適用するユーザーです。

/format

指定したラベルに関する情報を次のいずれかの形式で表示します。

  • Brief: ラベル、所有者、作成日が含まれます。 これは既定値です。
  • Detailed: コメント、スコープ、各ラベルに関連付けられているファイルとフォルダーの一覧も含まれます。

/collection

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

/login

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

解説

  • labels コマンドは、TFVC サーバー内のラベルに関する情報を表示します。 TFVC サーバーを指定しない場合、TFVC は現在のディレクトリを使用して TFVC サーバーを特定しようとします。 現在のディレクトリが TFVC サーバーにマップされていない場合は、/s オプションを使用して指定する必要があります。

  • 既定では、結果には各ラベルのラベル名、所有者、作成日が表示されます。 形式が detailed に変更された場合は、コメントと各ラベルに関連付けられているファイルとフォルダーの一覧も表示されます。

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

次の例では、ユーザー jasonj によって作成されたラベルの一覧が表示されます。

c:\projects> tf labels /owner:jasonj

次の例では、build1033 ラベルに関する情報が表示され、TFVC サーバーでラベルが適用されているファイルとフォルダーが一覧表示されます。

c:\projects> tf labels /format:detailed build1033

次の例では、build で始まる labelname を持ち、labels コマンドを実行するアカウントが所有する TFVC サーバー内のすべてのラベルが表示されます。

c:\projects> tf labels build*