Workfold コマンド
ワークスペースのフォルダーと Team Foundation バージョン管理 のサーバー上のフォルダー間のマッピングに関する情報を作成、変更、または表示します。
必要なアクセス許可
workfold コマンドを使用するには、指定されたワークスペースまたは暗黙のワークスペースの所有者であるか、グローバルな [ワークスペースの管理] のアクセス許可が [許可] に設定されている必要があります。 詳細については、「Team Foundation Server のアクセス許可」を参照してください。
tf workfold localfolder [/login:username,[password]]
tf workfold [/workspace:workspacename] [/login:username,[password]]
tf workfold [/collection:TeamProjectCollectionUrl] [/workspace:workspacename] [/login:username,[password]]
serverfolder
tf workfold [/map serverfolder localfolder] [/collection:TeamProjectCollectionUrl]
[/workspace:workspacename][/login:username,[password]
tf workfold /unmap [/collection:TeamProjectCollectionUrl] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder) [/login:username,[password]]
tf workfold /cloak
serverfolder [/workspace:workspacename] [/collection:TeamProjectCollectionUrl] [/login:username,[password]]
tf workfold /decloak serverfolder
[/workspace:workspacename] [/collection:TeamProjectCollectionUrl][/login:username,[password]]
パラメーター
引数 |
説明 |
|---|---|
workspacename |
/workspace オプションに対して、コマンドが操作するワークスペースの名前を指定します。 |
serverfolder |
Team Foundation バージョン管理 サーバー フォルダーの名前を指定します。 |
localfolder |
ローカル フォルダーの名前を指定します。 |
TeamProjectCollectionUrl |
サーバー フォルダーと比較するフォルダーを含むチーム プロジェクト コレクションの URL (http://myserver:8080/tfs/DefaultCollection/ など)。 |
username |
/login オプションに値を指定します。 ユーザー名の値は、DOMAIN\UserName または UserName のいずれかとして指定できます。 |
オプション |
説明 |
|---|---|
/workspace |
作業するワークスペースの名前を指定します。 |
/map |
ローカル フォルダーと Team Foundation バージョン管理 サーバー フォルダー間の関連付けを指定します。 既定では、指定されていなくても workfold コマンドでこのオプションが使用されます。ただし、/unmap、/cloak、または /decloak が指定されている場合は除きます。 |
/unmap |
ワークスペースから削除するフォルダー マッピングを指定します。 |
/cloak |
ワークスペースで行われたバージョン管理のアクションから除外するフォルダーを指定します。 |
/decloak |
フォルダーをワークスペースに取得できるようにフォルダーのクローク設定を解除します。 |
/collection |
チーム プロジェクト コレクションを指定します。 |
/login |
Visual Studio Team Foundation Server でユーザーを認証するためのユーザー名とパスワードを指定します。 |
解説
tf コマンド ライン ユーティリティの workfold コマンドを使用して、ワークスペース マッピングを作成および編集できます。 ワークスペース マッピングでは、tf get 操作を実行したときに Team Foundation バージョン管理 サーバー フォルダー内のすべてのファイルとサブフォルダーが取得されるクライアント側のフォルダーが作成されます。 get は、クライアント側のフォルダーがクローク設定されている場合は機能しません。
アスタリスク (*) ワイルドカードを指定して、ローカル ワークスペースに対して Team Foundation Server フォルダーおよび直下にある項目をマップすることもできます。 これは、"1 レベルのフォルダー マッピング" と呼ばれることもあります。
tf コマンド ライン ユーティリティの使い方の詳細については、「Tf コマンド ライン ユーティリティのコマンド」を参照してください。
ワークスペース マッピングのオプション
ワークスペース マッピングとは、アクティブな項目やクローク設定された項目の一覧のことです。 ワークスペース内の割り当てられた一覧に Team Foundation バージョン管理 サーバー項目を追加するには、/map オプションを使用します。 また、/cloak オプションを使用してワークスペースから項目を明示的に除外することもできます。 クローク設定できるのは、親が割り当てられている項目だけです。 クローク設定は、バッチによる Get 操作を速くしてディスク容量を節約する効果的な方法です。
クローク設定は、慎重に活用する必要があります。 コンパイルおよび統合の問題を回避するために必要な操作は、現在のプロジェクトや今後のプロジェクトの範囲外とわかっている項目 (イメージ ファイル、外部の文書ファイルなど) をクローク設定することだけです。
/unmap オプションおよび /decloak オプションを使用すると、割り当てられたエントリおよびクローク設定されたエントリをワークスペース マッピングから選択して削除できます。
ワークスペース マッピングが適用されるしくみ
既定では、ワークスペース マッピングは再帰的に適用されます。 Team Foundation バージョン管理 サーバー フォルダーにローカル フォルダーを割り当てると、そのフォルダーの現在のサブフォルダーと今後のサブフォルダーすべての間で暗黙のうちにマッピングが作成されます。 たとえば、c:\projects に $/projects を割り当て、その後に $/projects/project_one というプロジェクトを追加し、ワークスペースの get を実行すると、Team Foundation により、project_one という名前のローカル作業フォルダーが C:\projects ディレクトリに自動的に作成されます。
この例では、ワイルドカード (*) を使用して、ローカル ワークスペースに対してサーバー フォルダーおよび直下にある項目をマップできます。
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
次の例は、Team Foundation バージョン管理 サーバー フォルダー $/projects/project_one にフォルダー C:\DifferentWorkfold を割り当て、$/projects/project_one Team Foundation バージョン管理 サーバー フォルダーの以前のワークスペース マッピングを置換します。
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold