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

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

Visual Studio 2019 | Visual Studio 2022

Team Foundation バージョン管理 (TFVC) unlabel コマンドは、バージョン管理サーバーで既存のラベルから項目を削除します。

前提条件

unlabel コマンドを使用するには、ラベルの所有者であるか、[ラベルの管理] アクセス許可が [許可] に設定されている必要があります。 詳細については、「既定の TFVC アクセス許可」を参照してください。

構文

tf unlabel [/collection:<team-project-collection-url>] [/recursive] [/login:<username>, [<password>]] <label-name> <item-specification>

パラメーター

以降のセクションでは、unlabel コマンドの引数とオプションについて説明します。

引数

Argument

説明

<team-project-collection-url>

既存のラベルから削除する項目を含むプロジェクト コレクションの URL を指定します (例: https://myserver:8080/tfs/DefaultCollection)。

<label-name>

指定した項目から削除するラベルの名前を指定します。

<item-specification>

指定したラベルを削除する元のファイルまたはフォルダーを指定します。 TFVC が項目指定を解析して、どの項目がスコープ内か特定する方法について詳しくは、「Team Foundation バージョン管理コマンドの使用」を参照してください。

注意

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

<username>

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

<password>

/login オプションに値を指定します。

Options

オプション 説明
/recursive 特定のディレクトリとすべてのサブディレクトリ内にある、項目指定に一致するすべての項目から指定のラベルを削除します。
/collection プロジェクト コレクションを指定します。
/login Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。

解説

tf コマンド ライン ユーティリティの unlabel コマンドは、Azure DevOps サーバーで既存のラベルから項目を削除します。 ラベルの概要については、「ラベルを使用したファイルのスナップショット取得」を参照してください。 一連のファイルとフォルダーにラベルを割り当てる方法については、「Label コマンド (Team Foundation バージョン管理)」を参照してください。

Azure DevOps サーバーでラベルからすべての項目を削除すると、そのラベルが削除されます。 tf label /delete コマンドを使用することでもラベルを削除できます。 システム内の既存のラベルについて詳しくは、「Labels コマンド」を参照してください。

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

次の例では、314.cs から goodbuild ラベルを削除します。

c:\projects>tf unlabel goodbuild $/src/314.cs

次の例では、https://myserver:8080/tfs/DefaultCollection にあるコレクション内のすべてのファイルとフォルダーから Beta1 ラベルを削除します。

c:\projects>tf unlabel Beta1 $/ /collection:https://myserver:8080/tfs/DefaultCollection /recursive