Workfold コマンド (Team Foundation バージョン管理)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Team Foundation バージョン管理 (TFVC) の workfold コマンドでは、ワークスペース フォルダーと、TFVC 用 Azure DevOps サーバー上にあるフォルダーとの間のマッピングに関する情報を作成、変更、または表示します。
前提条件
workfold コマンドを使用するには、指定されたまたは暗黙的なワークスペースの所有者であるか、グローバルな [ワークスペースの管理] アクセス許可が [許可] に設定されている必要があります。 詳細については、「既定の TFVC アクセス許可」を参照してください。
構文
tf workfold <local-folder> [/login:<username>,[<password>]]
tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]
tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>
tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>]
[/workspace:<workspace-name>][/login:<username>,[<password>]
tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>]
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]
tf workfold /cloak
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]
tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]
パラメーター
以降のセクションでは、workfold コマンドの引数とオプションについて説明します。
引数
Argument
説明
<workspace-name>
コマンドが動作するワークスペースの名前を /workspace オプションで指定します。
<server-folder>
Azure DevOps サーバー フォルダーの名前を指定します。
<local-folder>
ローカル フォルダーの名前を指定します。
<team-project-collection-url>
サーバー フォルダーと比較するフォルダーを含むプロジェクト コレクションの URL (例: https://myserver:8080/tfs/DefaultCollection/)。
<username>
/login オプションに値を指定します。 この値は、DOMAIN\<username> または <username> として指定できます。
<password>
/login オプションに値を指定します。
Options
オプション
説明
/workspace
作業するワークスペースの名前を指定します。
/map
ローカル フォルダーと Azure DevOps サーバー フォルダーの間の関連付けを指定します。 既定では、/unmap、/cloakまたは /decloak が指定されていない限り、workfold コマンドでは (指定されていない場合でも) このオプションを使用します。
/unmap
ワークスペースから削除するフォルダー マッピングを指定します。
/cloak
ワークスペースで行われるバージョン管理アクションからフォルダーを除外することを指定します。
/decloak
フォルダーのクローク設定を解除して、フォルダーをワークスペースに取得できるようにします。
/collection
プロジェクト コレクションを指定します。
/login
Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。
解説
tf コマンド ライン ユーティリティの workfold コマンドを使用して、"ワークスペース マッピング" を作成および編集できます。 ワークスペース マッピングでは、 tf get 操作の実行時に Azure DevOps サーバー フォルダー内のすべてのファイルとサブフォルダーを取得するクライアント側フォルダーが作成されます。 クライアント側のフォルダーがクロークされている場合、get 操作は機能しません。
アスタリスク (*) ワイルドカード文字を使用して、Azure DevOps Server フォルダーとその直接の項目をローカル ワークスペースにマップすることもできます。 このマッピングは、しばしば "単一フォルダーのマッピング" と呼ばれます。
tf コマンド ライン ユーティリティの使用方法について詳しくは、「Team Foundation バージョン管理コマンドの使用」を参照してください。
ワークスペース マッピングのオプション
ワークスペース マッピングは、アクティブな項目とクロークされた項目の一覧です。 /map オプションを使用して、ワークスペース内のマップ済みリストに Azure DevOps サーバー項目を追加できます。 /cloak オプションを使用して、ワークスペースから項目を明示的に除外することもできます。 親がマップされている項目のみクロークできます。 クロークは、バッチの get 操作の速度を向上させ、ディスク上の領域を節約するための効果的な方法です。
クロークは慎重に使用してください。 コンパイルと統合の問題を回避するには、画像や外部ドキュメント ファイルなど、現在および将来のプロジェクトの範囲外であることがわかっている項目のみをクロークする必要があります。
/unmap と /decloak オプションを使用して、マップされた項目とクロークされた項目をワークスペース マッピングから選択的に削除できます。
ワークスペース マッピングの適用方法
既定では、ワークスペース マッピングは再帰的に適用されます。 ローカル フォルダーを Azure DevOps サーバー フォルダーにマップすると、システムではその現在と将来のすべてのサブフォルダー間のマッピングが暗黙的に作成されます。
たとえば、$/projects を C:\projects にマップするとします。 次に、$/projects/project_one という名前のプロジェクトを追加し、ワークスペースで get コマンドを実行します。 このシナリオでは、TFVC によって C:\projects ディレクトリに project_one という名前のローカル作業フォルダーが自動的に作成されます。
次の例では、アスタリスク (*) ワイルドカード文字を使用して、サーバー フォルダーとその直接の項目をローカル ワークスペースにマップします。
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
次の例では、workfold コマンドを使用して、$/projects/project_one と C:\projects\project_one の間で自動的に作成されるマッピングをオーバーライドします。
tf workfold $/projects/project_one C:\DifferentWorkfold
クロークにおけるマッピング
バージョン管理階層内のクロークされたフォルダーの下にある、クローク設定が解除されたフォルダーのマッピングは、ローカル ワークスペースにマップできます。
例
次の例では、c:\projects が存在するワークスペースのマッピングを示します。
c:\projects>tf workfold
次の例では、c:\projects\lib フォルダーをクロークします。
c:\projects>tf workfold /cloak c:\projects\lib
次の例では、ローカル ファイル word.cs のマッピングを示します。
c:\projects>tf workfold word.cs
次の例では、C:\DifferentWorkfold フォルダーを Azure DevOps サーバー フォルダー$/projects/project_one にマップし、$/projects/project_one Azure DevOps サーバー フォルダーの以前のワークスペース マッピングを置き換えます。
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold