Add コマンド
更新 : 2007 年 11 月
ローカル ファイル システムから Team Foundation バージョン管理サーバーへ新しいファイルまたはフォルダを追加します。
.gif "メモ") メモ : |
|---|
このコマンドの結果は、チェックイン操作を実行するまでは Team Foundation バージョン管理サーバーに反映されません。詳細については、「方法 : 保留中の変更をチェックインする」を参照してください。 |
必要なアクセス許可
add コマンドを使うには、ワークスペースの所有者であり、新しい項目の親フォルダの [チェックアウト] のアクセス許可が [許可] に設定されている必要があります。また、/lock:checkout または /lock:checkin を使う場合は、[ロック] のアクセス許可が [許可] に設定されている必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。
tf add itemspec [/lock:none|checkin|checkout] [/type:filetype]
[/noprompt] [/recursive]
パラメータ
引数 |
説明 |
|---|---|
itemspec |
追加するファイルまたはフォルダを指定します。Team Foundation で itemspecs を解析してスコープ内にある項目を確認する方法の詳細については、「コマンド ライン構文 (Team System)」を参照してください。 |
filetype |
/type オプションで使用します。詳細については、「ファイルの種類」を参照してください。 |
オプション |
説明 |
|---|---|
/type |
ファイルの種類マッチングをオーバーライドし、指定されたファイルの種類を使用して Team Foundation バージョン管理サーバーにファイルを追加します。詳細については、「ファイルの種類」を参照してください。 ファイルの種類は、ファイルの最初の 1 KB の内容に基づいて検出されます。 |
/lock |
ロックの種類を指定するか、項目からロックを削除します。 ロック オプション:
|
/noprompt |
入力用のプロンプトを表示しません。 |
/recursive |
指定されたディレクトリとサブディレクトリ内のすべての項目を追加します。 |
解説
バージョン管理に項目を追加する前に、ローカル ワークスペースがセットアップされ、作業フォルダ マッピングが確立している必要があります。作業開始の詳細については、「チュートリアル : コマンド ラインからの Team Foundation バージョン管理の操作」を参照してください。
Add は、項目を Team Foundation バージョン管理サーバーに追加するようスケジュールする保留中の変更コマンドで、ワークスペースからのチェックインの完了は保留になります。保留中の変更コマンドを実行するには、現在のディレクトリを、ワークスペースおよび対応する Team Foundation バージョン管理サーバーに割り当てる必要があります。
Add コマンドを使用して新しい項目をバージョン管理に追加すると、最新のワークスペースの変更をチェックインするまで、その項目は Team Foundation バージョン管理サーバーに追加されません。代わりに、その項目は、現在のワークスペースの保留中の変更一覧に追加されます。保留中の追加を Team Foundation バージョン管理サーバーにコミットするには、追加したファイルを直接チェックインするか、ローカル ワークスペース上のすべての保留中の変更をチェックインします。保留中の変更をチェックインするまでに、同じ名前のファイルまたはフォルダを別のユーザーが Team Foundation バージョン管理サーバーに追加する可能性がある場合には、Checkout パラメータに /lock オプションを指定して、競合を回避することができます。詳細については、「方法 : 保留中の変更をチェックインする」を参照してください。
tf add /teamproject/projects/math/314.cs を使って 314.cs をバージョン管理に追加する場合、変更をチェックインするまで、これらのフォルダのうちまだ存在しないものは保留中の追加と見なされます。変更をチェックインしたときに、指定されたパス内のいずれかのフォルダ (/teamproject、/teamproject/projects、または /teamproject/projects/math) が Team Foundation バージョン管理サーバー上になかった場合、Team Foundation が自動的にこれらを作成します。
Add コマンドを使用して、Team Foundation バージョン管理サーバーの初期ファイル構造を構築することもできます。詳細については、「チュートリアル : コマンド ラインからの Team Foundation バージョン管理の操作」を参照してください。
tf コマンド ライン ユーティリティの使い方の詳細については、「Tf コマンド ライン ユーティリティのコマンド」を参照してください。
例
次の例は、314.c ファイルと 1256.c ファイルを、作業フォルダ C:\Pi に関連付けられているワークスペースの保留中の変更一覧に追加します。
c:\pi>tf add 314.cs 1256.c
次の例は、現在のディレクトリと、そのサブディレクトリ内のすべての C# コード ファイル (.cs) を、現在のワークスペースの保留中の追加一覧に追加します。
c:\projects>tf add *.cs /recursive
次の例は、現在のディレクトリとそのすべてのサブディレクトリ内のファイルとフォルダの中で名前に "hello" が含まれるファイルとフォルダのすべてを、c:\projects に割り当てられているワークスペースの保留中の追加一覧に追加します。
c:\projects>tf add *hello* /recursive
参照
処理手順
チュートリアル : コマンド ラインからの Team Foundation バージョン管理の操作
方法 : 非プロジェクトまたは非ソリューションのファイルおよびフォルダをバージョン管理に追加する
方法 : フォルダまたはファイルをロックおよびアンロックする