Checkin コマンド

ファイルやフォルダーに対する保留中の変更をサーバーにチェックインします。

開発用コンピューター上のファイルに加えたほぼすべての変更は、保留中の変更としてワークスペースに格納されます。 変更をチェックインすると、サーバーに変更セットとして格納されます。 Checkin コマンドのユーザー インターフェイスは Visual Studio で使用できるものとは異なりますが (「チームのコードベースへの作業のチェックイン」を参照)、プロセスは基本的に同じです。

要件:Team Foundation Server のアクセス許可の参照」を参照してください。

tf checkin [/author:author name] [/comment:("comment"|@comment file)] 
[/noprompt] [/notes:("Note Name"="note text"|@notefile)] 
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/force] [/noautoresolve]  [/login:username,[password]] [/new]

tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]

パラメーター

パラメーター

説明

/author:author name

保留中の変更の作成者を指定して、あるユーザーが別のユーザーの代わりに変更をチェックインできるようにします。

CheckinOther アクセス許可が必要です。 「Team Foundation Server のアクセス許可の参照」を参照してください。

/bypass

ゲート チェックイン要件をバイパスする。 詳細については、「ゲート チェックイン ビルドによって制御されている保留中の変更内容のチェックイン」を参照してください。

/collection:TeamProjectCollectionUrl

/shelveset オプションを使用する場合、/collection オプションはシェルブセットを含むチーム プロジェクト コレクションの URL を指定します。 たとえば、「http://myserver:8080/tfs/DefaultCollection」を指定します。

既定では、チーム プロジェクト コレクションは現在のディレクトリをマップするワークスペースを含むコレクションであると見なされます。

/comment

次の引数の 1 つを使用してコメントを変更セットに関連付けます。

  • Comment: チェックインについてユーザーが指定したコメント。

  • @comment file: チェックインに関するコメントを含むディスク上のファイルのパス。

/force

ファイルの内容が変更されていない場合でも、保留中の編集のある項目を強制的にチェックインします。

itemspec

ユーザーのワークスペースからチェックインする項目のスコープを指定します。 複数の Itemspec 引数を指定できます。 構文については、「Team Foundation バージョン管理のコマンド リファレンス」を参照してください。

/login:username,[password]

コマンドを実行するユーザー アカウントが指定されます。 「Team Foundation バージョン管理のコマンド リファレンス」を参照してください。

/new

保留中の変更それぞれの選択された状態 ([チェックイン] ダイアログ ボックスに表示)、コメント、関連する作業項目、チェックイン メモ、およびチェックイン ポリシーのオーバーライドの理由は、チェックインするまで保留中の変更として開発用コンピューターに格納されます。 /new オプションは、チェックイン前にこのチェックイン メタデータをクリアします。

/noprompt オプションを使用すると、このオプションおよびその動作は無効になります。

/noautoresolve

既定では、[すべてを自動解決] の実行が自動的に試みられます (「Team Foundation バージョン管理の競合の解決」を参照)。 この既定の動作を無効にするには、このオプションを指定します。

/noprompt

ウィンドウとダイアログ ボックス ([チェックイン] ダイアログ ボックスなど) が表示されなくなり、出力データがコマンド プロンプトにリダイレクトされます。 「Team Foundation バージョン管理のコマンド リファレンス」を参照してください。

/notes

次の引数の 1 つを使用して 1 つ以上のチェックイン メモを指定し変更セットに関連付けます。

  • NoteFieldName=NoteFieldValue: チェックイン メモ フィールドの値を設定します。 セミコロン (;) で区切られた "field=value" 式を複数指定できます。

  • Notefile: チェックイン メモ フィールドの名前および値が "field=value" の形式で記述されているディスク上のファイルのパスを指定します。 次のようにセミコロンで区切ったメモを複数行に分けて記述することができます。

    Field1=Value1;

    Field2=Value2 の第 1 行

    Value2 の第 2 行;

    Field3=Value3;

/override

次の引数の 1 つを使用してチェックイン ポリシーを無視します。

  • reason: チェックイン ポリシーを無視する理由を指定します。

  • Reasonfile: チェックイン ポリシーを無視する理由が記述されたファイルのパスを指定します。

/recursive

指定されたディレクトリとサブディレクトリ内の項目を再帰的にチェックインします。

/saved

このパラメーターは無視してください。

/shelveset:shelvesetname[;owner]

チェックインするシェルブセットを指定します。 省略可能な引数 owner は、現在のユーザーが所有していないシェルブセットを指定するときに使用します。

注意

シェルブセットは、チェックイン後、削除されます。

/validate

ファイルをチェックインしないで、チェックインが成功するかどうかをテストします。 チェックイン ポリシーとチェックイン メモが評価され、競合が表示されます。

注意

/noprompt オプションを指定しない場合、チェックインを検証するには [チェックイン] ダイアログ ボックスで [チェックイン] をクリックする必要があります。このボタンをクリックすると、ファイルはチェックインされません。

現在のワークスペースにある保留中の変更をすべてチェックインする

c:\code\SiteApp\Main>tf checkin

[チェックイン] ダイアログ ボックスが表示され、現在のワークスペースにある保留中の変更がすべて表示 されます。 [チェックイン] ダイアログ ボックスで、チェックインする保留中の変更の選択または選択解除、コメントの追加、作業項目の関連付けなどの作業を実行して、準備ができたら [チェックイン] をクリックします。

保留中の変更をすべてコメント付きでチェックインする

c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"

現在のワークスペースにある保留中の変更をすべてチェックインし、チームメイトが変更の目的を理解できるようにコメントを指定します。

[チェックイン] ダイアログ ボックスを使用しないで 1 つの項目に対する変更をチェックインする

c:\code\SiteApp\Main>tf checkin program.cs /noprompt

program.cs に対する保留中の変更をチェックインします。 [チェックイン] ダイアログ ボックスは表示されず、競合によってチェックインができない場合でも、競合ウィンドウは表示されません。

Visual Studio での作業

ヒント

  • ヒント 変更を棚上げ (および別のタスクのためにワークスペースをクリーンアップ) するには、Shelve コマンドを使用します。

  • ヒント 競合によってチェックインできない場合は、Resolve Commandを使用して競合を解決できます。

  • ヒント コンピューターとユーザー アカウントに、シェルブセットを含むチーム プロジェクト コレクションにマップされたワークスペースがない場合は、/shelveset オプションと /collection オプションを使用してシェルブセットをチェックインできます。