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

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

Visual Studio 2019 | Visual Studio 2022

Team Foundation バージョン管理 (TFVC) の localversions コマンドは、ワークスペース内の 1 つ以上の項目のバージョンを表示します。

前提条件

localversions コマンドを使用するには、ワークスペースに対する使用アクセス許可が必要です。 詳細については、「既定の TFVC アクセス許可」を参照してください。

構文

tf localversions ItemSpec
[/recursive] [/format:brief|detailed]
[/workspace:WorkspaceName[;WorkspaceOwner]] [/collection:TeamProjectCollectionUrl]

パラメーター

引数

Argument

説明

<itemspec>

バージョン番号を表示するファイルを含むファイルまたはフォルダーを指定します。

指定できるのは、ローカル ファイルまたはフォルダーのみです。 たとえば、c:\project1\binder.cs は有効ですが、$/project1/binder.cs は有効ではありません。

注意

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

<workspacename>

この引数を /workspace オプションと共に使用して、現在のディレクトリにマップされているワークスペース以外のワークスペースを指定します。

<workspaceowner>

パブリック ワークスペースを指定する場合は、workspacename 引数と共にこの引数を使用します。

<TeamProjectCollectionUrl>

バージョンを表示する 1 つ以上の項目を含むプロジェクト コレクションの URL (例: http://myserver:8080/tfs/DefaultCollection)。

Options

オプション

説明

/format

次のいずれかのオプションを指定して、このコマンドによって返されるデータの表示方法を制御します。

• Brief (既定値): 各ディレクトリは 1 回だけ表示され、その後に含まれるファイルが表示されます。
• Detailed: 各ファイルは、その完全なパスの後に表示されます。

/recursive

操作でサブフォルダーに項目を含める場合は、このオプションを指定します。

/workspace

現在のディレクトリにマップされている項目以外のワークスペース内の項目のバージョンに関するデータを表示するには、このオプションを指定します。

/collection

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

解説

ファイルを取得またはチェックアウトする場合は、通常、最新バージョンをダウンロードします。 ただし、ワークスペースに以前のバージョンのファイルが含まれる場合があります。

たとえば、一部のファイルをチェックアウトし、数週間作業をチェックインしていない場合があります。 その間にチームの他のユーザーが、同じファイルに対する変更をチェックインしている可能性があります。 この場合、ワークスペース内のこれらのファイルのバージョンは、TFVC のサーバー上の現在のバージョンよりも古くなります。 localversions コマンドを使用すると、ワークスペース内にこれらのファイルのどのバージョンがあるかに関する情報を取得できます。

その他の TFVC コマンドでは、TFVC のサーバー内の項目と、それにマップされるワークスペースに関する詳細情報が提供されます。 tf コマンド ライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。

例

次の例では、c:\workspaces\FeatureA\catalog\controller フォルダーにマップされているワークスペース内の ControllerBase.cs ファイルのバージョンを表示します。

c:\workspaces\FeatureA\catalog\controller>tf localversions ControllerBase.cs

次の例では、c:\workspaces\FeatureA\catalog フォルダーにマップされているワークスペース内のすべてのファイル (サブフォルダー内のファイルを含む) のバージョンを表示します。 /format:detailed オプションが指定されているため、各ファイルは完全なパスで表示されます。

c:\workspaces\FeatureA\catalog\>tf localversions . /recursive /format:detailed