Branch コマンド (Team Foundation バージョン 管理)
Azure DevOps Services の |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
TFVC branch コマンドは、Azure DevOps サーバーとローカル ワークスペース内の 1 つの場所から別の場所に、メタデータやバージョン管理履歴を含む項目または項目のセットをコピーします。
手記
このコマンドの結果は、チェックイン操作を実行するまで Azure DevOps サーバーには反映されません。 詳細については、「チームのコードベースに作業をチェックインする」を参照してください。
前提 条件
branch コマンドを使用するには、ソースアイテムの 読み取り 権限を持ち、ターゲットフォルダの チェックアウト および マージ 権限を 許可に設定します。 詳細については、「既定の TFVC アクセス許可 」を参照してください。
構文
tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]] [/recursive]
パラメーター
引数
| 引数の | 説明 |
|---|---|
<olditem> |
分岐するソース ファイルまたはフォルダーの名前を指定します。
<olditem> には、item;version形式のバージョン情報を含めることもできます。 |
<newitem> |
コピー先のファイルまたはフォルダーの名前、またはコピー先の親フォルダーの名前を指定します。
<*newitem> が既に存在し、Azure DevOps Server フォルダーである場合、TFVC はその中に分岐項目を作成します。 それ以外の場合、<newitem> は、コピー先のファイルまたはフォルダーの名前を指定します。 コピー先が既に存在する場合、チェックイン中に競合が発生する可能性があります。 |
<versionspec> |
/version オプションの値を提供します。 TFVC がバージョン仕様を解析してスコープ内にある項目を決定する方法の詳細については、「Team Foundation バージョン管理コマンドを使用する」を参照してください。 |
<comment> |
ブランチに関するコメントを提供します。 |
@<commentfile> |
分岐に使用されるコメントを含むファイルのパスを指定します。 |
<authorname> |
/author オプションのユーザー指定の値。 |
<username> |
/login オプションに値を提供します。 ユーザー名の値は、DOMAIN\username または <username>として指定できます。 |
オプション
オプションの
説明
/version
ブランチを作成するアイテムのバージョン。 バージョンは次の方法で指定できます。
- 日付/時刻 (D10/20/2005)
- 変更セット番号 (C1256)
- Label (Lmylabel)
- 最新バージョン (T)
- Workspace (Wworkspacename)
バージョンが指定されていない場合、TFVC は次のロジックを使用して、新しいブランチにコピーする項目のバージョンを決定します。
- Azure DevOps Server パスが指定されている場合、TFVC は最新の Azure DevOps Server バージョンで項目を分岐します。 たとえば、
tf branch $/projects/help.csはサーバー バージョンを使用します。 - ソースにローカル パスが指定されている場合、TFVC はローカルのワークスペース バージョンを使用して新しいブランチを作成します。 たとえば、
tf branch C:\314.csはローカル ワークスペースのバージョンを使用します。
ワークスペースのバージョンが Azure DevOps サーバーの最新バージョンより古いファイルをブランチする場合、ファイルは古いバージョンで分岐されます。
/lock
保留中のブランチと関連する変更をチェックインするまで、他のユーザーがアイテムをチェックインまたはチェックアウトできないようにします。 詳細については、「ロックの種類について」を参照してください。
ロック オプション:
none
デフォルト。 ロックは適用されません。 ブランチを作成するファイルにロックが存在する場合、このオプションによって削除されます。checkin
他のユーザーは指定されたアイテムをチェックアウトできますが、チェックインを実行してロックを解除するまで、ロックされたファイルのリビジョンをチェックインすることはできません。 他のユーザーが指定された項目のいずれかをロックした場合、ロック操作は失敗します。checkout
チェックインを実行してロックを解除するまで、他のユーザーが指定した項目のいずれかをチェックインまたはチェックアウトできないようにします。 他のユーザーが指定された項目のいずれかをロックした場合、ロック操作は失敗します。
/noget
このオプションを指定すると、新しいブランチ内のファイルとフォルダーのローカル コピーはローカル ワークスペースに作成されません。 ただし、ローカル コピーは、次回再帰的な取得操作を実行するときにワークスペースに取得されます。
手記
/images フォルダーの内容などの項目が、再帰的な取得中にワークスペースに取得されないようにし、ワークスペース フォルダーをクロークすることで、最新の操作を取得することができます。 詳細については、「Workfold コマンド」を参照してください。
/noprompt
ユーザーからの入力を求めるメッセージが表示されないようにします。
/silent
/nogetを意味し、ブランチを作成するときにコマンド プロンプト ウィンドウに出力が書き込まれないことを指定します。
/checkin
ブランチを 1 回の操作でサーバーに作成してチェックインします。 このオプションでは、ローカル ワークスペースに保留中の変更は作成されません。
/comment
新しいブランチにコメントを追加します。 このオプションは、/checkin オプションでのみ使用されます。
/author
新しいブランチの作成者を識別します。 このオプションは、/checkin オプションでのみ使用されます。
/recursive
フォルダーの場合は、内部のすべてのファイルも分岐します。
備考
c:\00101 などのローカル パスを指定し、<versionspec>を指定しない場合、TFVC は新しいブランチを作成するための基礎としてローカル ワークスペース バージョンを使用します。
ただし、$/00101/*.cs などのサーバー パスを指定し、<versionspec>を指定しない場合、TFVC は新しいブランチを作成するための基礎として最新の Azure DevOps Server バージョンを使用します。
tf コマンドライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドを使用する」を参照してください。
例
次の例では、c:\projects がワークスペース内のメイン フォルダーにマップされることを前提としています。
次の例では、最新のワークスペース バージョンの 314.csを含むブランチ ファイルを作成し、314_branch名前を付け、ディスク上の現在のディレクトリと、マップ先の Azure DevOps Server フォルダーに保存します。
c:\projects>tf branch 314.cs 314_branch
次の例では、ワークスペース バージョンの
c:\projects>tf branch C:\314.cs $/testdata
次の例では、現在のワークスペース バージョンの testfiles フォルダー内の保留中の編集なしですべてのファイルをコピーし、現在の Azure DevOps Server フォルダーのすべてのアイテムに含まれるファイルを、testfiles_branch Azure DevOps Server フォルダーにコピーし、c:\testfiles から、testfiles_branch Azure DevOps Server フォルダーにマップするローカル フォルダーにコピーします。
c:\projects>tf branch C:\testfiles $/testfiles_branch
次の例では、ファイルの changeset #4 に存在していた 314.cs の分岐を作成します。 Azure DevOps サーバーと同様に、ディスク上の作業フォルダーに、csharp_branch というタイトルのブランチ ファイルが作成されます。
c:\projects>tf branch C:\314.cs;C4 csharp_branch
次の例では、12/12/03 と同じように、314.cs の新しい分岐を作成します。 Azure DevOps サーバーと同様にディスク上の作業フォルダーに、314\branch という名前のブランチ ファイルが作成されます。
c:\projects>tf branch 314.cs;D12/12/03 314_branch
次の例では、
c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch