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

[アーティクル]
04/04/2024

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

Visual Studio 2019 | Visual Studio 2022

Team Foundation バージョン管理 (TFVC) get コマンドを使用すると、Azure DevOps Server からワークスペースに、最新バージョンまたは指定されたバージョンの 1 つ以上のファイルまたはフォルダーを取得またはダウンロードできます。 tf get コマンドのユーザーインターフェイスは Visual Studio と異なりますが、プロセスは基本的に同じです。 Visual Studio を使用してファイルとフォルダーを取得する方法の詳細については、サーバーからのファイルのダウンロード (取得) に関する記事を参照してください。

前提条件

「既定の TFVC アクセス許可」を参照してください。

構文

tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]

Parameters

パラメーター

説明

/all

このオプションを使用すると、サーバーワークスペースから間違って削除した項目を復元できます。推奨のローカルワークスペースを使用する場合、このオプションを使用する必要はほとんどありません。

TFVC には、ワークスペースに存在するすべての項目の内部レコード (各バージョンを含む) が保持されています。既定では、ファイルを取得するとき、取得しようとしているバージョンが既にワークスペースにあることをサーバー上の内部レコードが示している場合、それらのファイルは取得されません。このオプションは、内部レコードに含まれるデータに関係なく、すべての項目を取得します。

/force

/all と /overwrite を組み合わせます。

<itemspec>

取得する項目の範囲が指定されます。複数の itemspec 引数を指定できます。 itemspec を指定しない場合、現在のワークスペース内のすべての項目が再帰的に取得されます。

構文については、「Team Foundation バージョン管理コマンドの使用」を参照してください。

/login <username>,[<password>]

コマンドを実行するユーザーアカウントが指定されます。「Team Foundation バージョン管理コマンドの使用」を参照してください。

/noautoresolve

既定では、競合に対して [すべてを自動解決] が自動的に試行されます。詳細については、「Team Foundation バージョン管理の競合の解決」を参照してください。この既定の動作を無効にするには、このオプションを指定します。

/noprompt

Visual Studio のウィンドウとダイアログボックスが表示されなくなり、出力データがコマンドプロンプトにリダイレクトされます。「Team Foundation バージョン管理コマンドの使用」を参照してください。

/overwrite

既定では、項目がクライアントコンピューターで書き込み可能であり、読み取り専用属性が解除されている場合、システムはその項目を取得しません。このオプションは、項目がチェックアウトされない限り、既定の動作をオーバーライドし、書き込み可能な項目を上書きします。推奨のローカルワークスペースを使用している場合は、このオプションを使用する必要はほとんどありません。

/preview

get 操作を実際に実行することなく、操作結果を表示します。

/recursive

指定されたディレクトリとサブディレクトリ内の項目が再帰的に取得されます。 itemspec を指定しない場合、このオプションが暗黙的に指定されます。

/remap

phkelley のブログの「tf get /remap」を参照してください。

/version:<versionspec>

履歴データを表示する最大バージョン、または最小バージョンと最大のバージョンが指定されます。既定値は /version:T (最新バージョン) です。

構文については、「Team Foundation バージョン管理コマンドの使用」を参照してください。

解説

新しいタスクを開始する場合、ファイルをチェックアウトして作業を開始する前に、サーバーから最新ファイルをダウンロードするために tf get を実行することをお勧めします。ワークスペース内の任意のフォルダーから tf get を実行できます。
必要に応じて、tf get により、コマンドによりダウンロードされる子項目が格納されるフォルダーがディスクに作成されます。
項目の履歴に関する情報は、History コマンドと Changeset コマンドを使用して表示できます。
ワークスペース内のファイルに加えようとしている変更に関する懸念事項がある場合、/preview を使用すると、変更を実際に適用しなくても変更の結果を確認することができます。
競合によって get がブロックされることがあります。競合の一般的な原因として、保留中の変更がある項目を取得しようとしていることが考えられます。 Resolve コマンドを使用すると、これらの競合を解決できます。

例

次の例は、$/SiteApp/Main/ がワークスペース内の c:\code\SiteApp\Main\ にマップされていることを想定しています。

ワークスペース内のすべての項目の最新バージョンを取得する

既定では、tf get コマンドを使用すると、ワークスペース内の最新バージョンの項目をすべて取得できます。たとえば、次のコマンドはすべての子フォルダーを含めて $/SiteApp/Main/ 内のすべてのファイルを再帰的に取得します。

c:\code\SiteApp\Main>tf get

フォルダー内の特定の種類の項目の最新バージョンを再帰的に取得する

次の例では、c:\code\SiteApp\Main\SolutionA\Project1 内の最新バージョンの C# ファイルをすべて取得します。

c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive

ファイルの最新バージョンを取得する

次の例では、Project1 の最新バージョンの program.cs を取得します。

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs

ファイルの指定バージョンの確認

次の例では、Project1 のバージョン 8 の program.cs を取得します。

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8

2 つのファイルの最新バージョンを取得する

次の例では、Project1 の最新バージョンの file1.cs と file2.cs を取得します。

c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs

ワークスペースを同期して、チームのコードベースのバージョンに合わせる

次の例では、ワークスペースを同期し、変更セット 15 が作成されたときに存在していたコードベースに合わせます。

c:\code\SiteApp\Main>tf get /v:15

ワークスペース内のすべての項目の名前と内容が、サーバーに存在していたときの状態に合わせて変更されます。
その変更セット以降に削除された項目がワークスペースに復元されます。
その変更セット以降の追加された項目がワークスペースから削除されます。

ワークスペースを同期して、チームのコードベースのラベル付きバージョンに合わせる

次の例では、ワークスペースを同期し、LastKnownGood というラベルが付いたコードベース内の項目に合わせます。

c:\code\SiteApp\Main>tf get /v:LLastKnownGood

ワークスペース内のラベルが付いたすべての項目の名前と内容が、サーバーに存在していたときの状態に合わせて変更されます。
削除されたラベル付き項目がワークスペースに復元されます。
サーバー上のラベルが付いていない項目がワークスペースから削除されます。