Team Foundation バージョン管理のコマンド リファレンス
は、Visual Studio のできるほとんどのタスクを行うバージョン コントロールのコマンドは、Visual Studio でできないまたは複数のタスクを使用できます。コマンド プロンプトからまたはスクリプト内でバージョン管理のコマンドの実行に tf.exe ツールを使用できます。
目的に合ったトピックをクリックしてください
コマンドを実行します。
dev ようにコンピューターを設定します。
独自のアプリケーションを開発します。
作業を中断します。
作業を提供します。
ファイルを管理し、問題を解決します。
リスクを特定します。
コマンド構文を理解します。
コマンドによって影響を受けるアイテムを指定します。
影響を受ける項目を指定するには、itemspec の引数を使用します。
項目の影響を受けるバージョンを指定するには、versionspec の引数を使用します。
変更するには、オプションをコマンドの機能を使用します。
データ入力用の要求を中止し、コマンド プロンプト ウィンドウに出力データをリダイレクトするには、/noprompt オプションを使用します。
コマンドを実行時に資格情報を指定するために /login オプションを使用します。
ロックを追加または削除するには /lock オプションを使用します。
オプションのショートカットを使用します。
終了コードを理解します。
コマンドを実行します。
Visual Studio コマンド プロンプトを、Windows [開始] から起動するには、[Microsoft Visual Studio 2012]、[Visual Studio ツール] を選択し、[コマンド プロンプト] 1 のショートカットを選択します。
ほとんどの場合、ワークスペースでマップされたフォルダーのコンテキストでバージョン管理のコマンドを実行します。たとえば、$/SiteApp/Main/ は c:\code\SiteApp\Main\にマップされます。ワークスペース内のすべての項目の最新バージョンを取得するには:
c:\code\SiteApp\Main\SolutionA>tf get
[!メモ]
このトピックは、現在の一部を再発行しません。ただし、これらのトピックでは、Visual Studio 2010 のバージョンを読み取ることができます。
dev ようにコンピューターを設定し、ワークスペースを管理します。
ワークスペースは、チームのコードベースのローカル コピーです。実際の dev コンピューターのローカル コピーであるため、開発し、準備が整うまでの分離コードをテストするには、作業をチェックインします。ワークスペースを管理するコマンドを次に示します。:
Proxy Command (Visual Studio 2010)
WorkFold Command (Visual Studio 2010)
Workspace Command (Visual Studio 2010)
Workspaces Command (Visual Studio 2010)
参照: 開発用コンピューターの設定とバージョン管理の使用の開始ワークスペースの管理
独自のアプリケーションを開発します。
チームは、バージョン コントロールの対象のアプリケーションを開発するこれらのコマンドの使用:
Add コマンド
バージョン管理のためにファイルおよびフォルダーを追加します。Checkout コマンド (および Edit コマンド)
チェック アウト "編集" にファイルおよび変更の保留中の変更の状態。Delete コマンド (Team Foundation バージョン管理) (Visual Studio 2010)
Get コマンド
Team Foundation Server からワークスペースには、一つ以上のファイルまたはフォルダーの最新または指定したバージョンを取得 (ダウンロード) します。Rename コマンド (Team Foundation バージョン管理) (Visual Studio 2010)
Status コマンド
一つ以上のワークスペース、またはシェルブセットのファイルおよびフォルダー項目に対する保留中の変更に関する情報を表示します。Undo コマンド
ファイルまたはフォルダーに一つまたは複数の保留中の変更を破棄。Undelete Command (Visual Studio 2010)
参照: バージョン管理されたコードベースでのアプリケーションの開発
作業を中断します。
さまざまな理由で、中断し、いくつかのニーズまたはすべてのすぎない。中断し、作業を再開し、シェルブセットを管理するには、次のコマンドを使用します:
Shelve コマンド (Visual Studio 2010)
Shelvesets Command (Visual Studio 2010)
Unshelve コマンド (Visual Studio 2010)
参照: 作業の中断とシェルブセットの管理。
作業を提供します。
ここでのチームのコードベースに、コードのチェックイン:
- Checkin コマンド
サーバーに対してファイルまたはフォルダーへが保留中の変更。
ファイルを管理し、問題を解決します。
表示および管理のバージョン管理ファイルおよびフォルダー
Properties コマンド (Visual Studio 2010)
Property コマンド (文書化なし)
Dir Command (Visual Studio 2010)
Destroy Command (Visual Studio 2010)
LocalVersions Command (Visual Studio 2010)
のバージョンを表示および管理
Changeset Command (Visual Studio 2010)
History コマンド
一つ以上のファイルまたはフォルダーのリビジョン履歴が表示されます。Label Command (Visual Studio 2010)
Labels Command (Visual Studio 2010)
Rollback Command (Visual Studio 2010)
Unlabel Command (Visual Studio 2010)
View Command (Visual Studio 2010)
参照: 旧バージョンの表示と管理
フォルダーとファイルを比較します。
Difference Command (Visual Studio 2010)
Folderdiff Command (Visual Studio 2010)
参照: 旧バージョンの表示と管理
ファイルの競合の解決
Resolve Command (Visual Studio 2010)参照: ファイルの競合の解決。
バージョン コントロールのロックを使用
Lock Command (Visual Studio 2010)参照: バージョン管理のロック操作。
リスクを特定します。
分岐を使用してリスクを分離する次のコマンドを使用する:
Branch Command (Visual Studio 2010)
Branches Command (Visual Studio 2010)
Merge Command (Visual Studio 2010)
Merges Command (Visual Studio 2010)
参照: 分岐を使用したリスクの分離。
バージョン コントロールの管理
いるバージョン管理システムを管理次のコマンドを使用する:
Configure Command (Visual Studio 2010)
Permission Command (Visual Studio 2010)
参照: Team Foundation バージョン管理の管理 (Visual Studio 2010)。
バージョン管理コマンドのヘルプを取得します。
バージョン コントロールのコマンドに関する詳細な情報を取得する次のコマンドを使用する:
Help Command (Visual Studio 2010)
Msdn Command (Visual Studio 2010)
コマンド構文を理解します。
各コマンドの構文は、各リファレンス トピックの上部に表示されます。
必須インターフェイスと省略可能な引数
角かっこで囲まれていない引数が必要です。[Brackets] は、コマンドを実行する必要がない省略可能な引数を示します。ただし、省略可能な引数のオプションを指定しない場合でもコマンドに適用される既定値があります。
排他的な引数
オンで区切られたがパイプ (|)、オプションの 1 つが指定できます。
逐語的で、置き換え可能な引数
太字の項目は、逐語的に指定するオプションです。イタリック体にする の項目は、コマンドを実行するために実際の文字で置き換える必要がある引数です。
コマンドのショートカットとエイリアス
一部のコマンドがショートカットをサポートします。たとえば、tf delete または tf delの 削除コマンド を呼び出すことができます。
例
たとえば、チェック アウト コマンド:
tf checkout [/lock:( none|checkin|checkout)] [/recursive] itemspec [/login: username,[ password]]
この例の引数を見直そう:
itemspec: itemspec にチェックインする項目を指定するこの引数を置き換える必要があります。
/lock:(none|checkin|checkout): /lock のオプションを指定する必要はありません。これを指定しない場合、システムは既定で /lock:noneを指定します。それ以外の場合、ロック オプションの 1 つが指定できます。
次の引数は省略可能であり、それらを指定する、効果がない場合は、コマンドに適用できません:
/recursive: 再帰的にチェック アウト フォルダーに、の複数の項目をこのオプションを逐語的に指定する必要がある場合は。
/login:ユーザー名パスワード、: 別のユーザーとしてコマンドを実行する場合は /login のオプションを、ユーザーの名前に置き換えます ユーザー名 逐語的に指定し、必要に応じて、パスワードを指定できます。
コマンドによって影響を受けるアイテムを指定します。
どの項目がコマンドによって影響を受けるかを指定するには、itemspecs とバージョン指定を使用できます。
影響を受ける項目を指定するには、itemspec の引数を使用します。
コマンドによって影響を受ける項目を指定するには itemspec (項目の指定) を使用します。クライアント コンピューターまたは、Team Foundation Server の項目を指定できます。* と **?**などのワイルドカード文字を使用できます。
クライアントの itemspec の引数
クライアントの itemspec の引数は、フォルダーなどのクライアント コンピューターで項目のパス (たとえば、) ファイル **c:\code\SiteApp\Main\SolutionA\**指定します (たとえば、c:\code\SiteApp\Main\SolutionA\Project1\program.cs または複数のファイル (たとえば、c:\code\SiteApp\Main\SolutionA\*.cs。また \\myshare\code\SiteApp\Mainなどの UNC パスを指定できます。
サーバーの itemspec の引数
サーバーの itemspec の引数は、フォルダーなど、Team Foundation Server で項目のパス (たとえば、) ファイル $/SiteApp/Main/SolutionA指定します (たとえば、$/SiteApp/Main/SolutionA/Project1/program.cs または複数のファイル (たとえば、$/SiteApp/Main/SolutionA/*.cs。
実行をクライアント コンピューターのコマンドない必要とする場合、通常はサーバーの itemspec の引数を使用します。たとえば、dev のコンピューターで作業は、で使用してチーム プロジェクト コレクション内の一部の項目のリビジョン履歴のあるデータを取得する必要があります:
c:\>tf history /collection:http://fabrikam-3:8080/tfs/DefaultCollection
$/SiteApp/Main/SolutionA/Project1/* /recursive
/noprompt
複数の itemspec の引数
一部のコマンドは、itemspec の複数の引数を指定できます。次に例を示します。
c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c
チェック アウト program.cs と program2.c。
項目の影響を受けるバージョンを指定するには、versionspec の引数を使用します。
コマンドによって影響を受ける項目のバージョンを指定するために versionspec (バージョン仕様) を使用します。versionspec を提供するには:
/version オプションを使用します。たとえば、/version:C44 となります。
セミコロンの itemspec でバージョンを追加します。たとえば、program1.cs;C44 となります。
History コマンド または Difference Commandを使用すると、ティルダは、バージョンを分離してバージョンの範囲を指定できます (|)。次に例を示します。
c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012
versionspecを指定するには、次の構文を使用します。
型 |
構文 |
説明 |
---|---|---|
変更セット |
[C]n |
変更セット番号に基づいて項目を指定します。スコープ内にある項目が指定された変更セットで変更しない限り、指定した変更セットの前に発生した項目の最新バージョンを取得します。
ヒント
番号だけを指定する C を省略できます。
例
または
または
readme.txt が変更セット 8 で変更されている場合は、ファイルのバージョンを取得します。それ以外の場合は、バージョン 8.の前に readme.txt の最新バージョンを取得します。 |
Label |
Llabel |
label が適用された項目を指定します。 例
JulyHotFixとラベル readme.txt のバージョンを取得します。
LastKnownGood のラベル変更セットが 自動ビルド プロセスの一部として、たとえばを使って作成されたときに存在していたワークスペースのすべてのラベル項目 (および削除のバージョンにラベルを付ける作業項目) 取得します。 |
日時 |
Dyyyy-mm-ddTxx:xx または Dmm/dd/yyyy または .NET Framework がサポートする任意の形式。 または ローカル コンピューターでサポートされている日付形式。 |
作成された特定の日付と時刻に変更セットを指定します。 例
00:00 (深夜) に 3/22/2004 にあったときに、ワークスペースをコードベースに一致するように更新します。
09:00 (午前 9 時) に 3/22/2004 にあったときに、ワークスペースをコードベースに一致するように更新します。 .NET に関する詳細については、フレームワーク サポートされる日付と時刻のファイル形式は DateTime と 標準の日付と時刻の書式指定文字列が表示されます。 |
ワークスペース (現在の) |
W |
ワークスペースでバージョンを指定します。 |
(指定された) ワークスペース |
Wworkspacename; workspaceowner |
指定されたワークスペースでバージョンを指定します。 たとえば、「WResolveRIConflicts;PeterW」のように指定します。 |
ヒント |
T |
最新バージョンを指定します。 |
変更するには、オプションをコマンドの機能を使用します。
コマンドの機能の変更に共通のオプションを使用できます。
データ入力用の要求を中止し、コマンド プロンプト ウィンドウに出力データをリダイレクトするには、/noprompt オプションを使用します。
データ入力用の要求を中止し、コマンド プロンプト ウィンドウに出力データをリダイレクトするには /noprompt のオプションを使用します。このオプションは、スクリプトが解析したり、キャプチャなどの操作を実行できるようにコマンドが、ユーザーによる操作せずに進み、データを利用できるため、スクリプトでバージョン管理のコマンドを使用する必要がある場合に便利です。
このオプションを使用すると、システム:
入力のすべての要求を中止します:
質問がコマンド プロンプト ウィンドウに尋ねられません。たとえば、このオプションの Undo コマンド を使用すると、変更を元に戻すことを続行する場合は、確認するメッセージは表示されません。
ウィンドウとダイアログ ボックスは表示されません。たとえば、Checkin コマンドのこのオプションを使用します。(項目がチェックインすることも、の [チェックイン] のダイアログ ボックスを表示せずに関連付ける作業項目を確認する場合)、選択、システムは認識せずにチェックインに進みます。
コマンド プロンプトに出力データをリダイレクトします。たとえば、History コマンドのこのオプションを使用します。データは [履歴]ウィンドウの代わりにコマンド プロンプト]ウィンドウに表示されます。
コマンドを実行時に資格情報を指定するために /login オプションを使用します。
Team Foundation Server のユーザー アカウントをコマンドを実行するように指定するには /login のオプションを使用します。このオプションは、他のチーム メンバーのコンピューターで作業する場合に便利です。
たとえば、ジュリア dev は、自分のコンピューターで Peter に動作しています。Alice はそのファイルのロックを解除するために ロック コマンド を、ロックされる前に使用します:
c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI,JuliaPassword
Alice は自分のパスワードがあることを避けるには、コマンド プロンプトで表示する、Alice はパスワードを指定せずにコマンドを入力できます:
c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI
ユーザーがこのコマンドを入力した後、システムは、SEH をユーザーの入力をマスク ダイアログ ボックスに自分のパスワードを入力するよう求められます。
ロックを追加または削除するには /lock オプションを使用します。
重要 |
---|
ベスト プラクティスとして、項目をロックする理由、とロックを削除することを計画するか、細心の注意 /lock オプションを使用して、他のチーム メンバーに通知します。 |
適用するには /lock のオプションを使用してロックを削除するには同時に [追加] または [編集]などの別のコマンドを実行します。
/lock:(none|checkin|checkout)
None: 項目にロックは適用されません。既にロックが適用されている場合は、解除されます。
Checkin または Checkout: ロックを適用します。「ロックの種類について」を参照してください。
[!メモ]
いくつかのケースでは、ロック操作は失敗する可能性があります:
他のユーザーが指定した項目のロックした場合、ロック操作は失敗します。
システムが既に項目に対する保留中の変更がある場合は、このスイッチを無視します。この場合、項目のロックを変更するには、Lock Command を使用する必要があります。
オプションのショートカットを使用します。
次のオプションを省略できます。
オプション |
オプションのエイリアス |
---|---|
/comment |
-C |
/computer |
-M |
/delete |
-D |
/force |
-P |
/format |
-F |
/help |
-?, -H |
/lock |
-K |
/login |
-Y |
/newname |
-N |
/noprompt |
-I |
/owner |
-O |
/recursive |
-R |
/server |
-S |
/slotmode |
-X |
/template |
-T |
/user |
-U |
/version |
-V |
/workspace |
-W |
終了コードを理解します。
バージョン コントロールのコマンドは、次の終了コードを返します:
終了コード |
定義 |
---|---|
0 |
成功。 |
1 |
部分的な成功。少なくとも一部、場合によってはすべてが成功しなかったことを意味します。 |
2 |
認識されないコマンド。 |
100 |
完全な失敗。 |
次に例を示します。
c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c
実行しようとしているファイルの 1 つがチェック アウト コマンドは、サーバーに返されます部分的な成功を示すに 1 をありません。