Labels コマンド (Team Foundation バージョン管理)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
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*