Checkin コマンド

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

TFVC checkin コマンドは、保留中のファイルとフォルダーの変更をサーバーにチェックインします。

開発マシン上のファイルに加えたほぼすべての変更は、保留中の変更としてワークスペースに保存されます。 変更をチェックインすると、サーバーに変更セットとして保存されます。 checkin コマンドは、「チームのコードベースへの作業のチェックイン」で Visual Studio についてドキュメント化されているのと同じプロセスを実行するための別のユーザー インターフェイスを提供します。

ヒント

  • 変更を保留したり、別のタスクのためにワークスペースをクリーンアップするには、Shelve コマンド を使用します。

  • 競合によってチェックインがブロックされている場合は、Resolve コマンドを使用して解決できます。

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

前提条件

構文

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]

Parameters

パラメーター

説明

/author:<author name>

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

CheckinOther アクセス許可が必要です。 アクセス許可とグループのリファレンスを参照してください。

/bypass

ゲート チェックイン要件をバイパスする。 詳細については、「ゲート チェックイン ビルド処理によって制御されるフォルダーにチェックインする」を参照してください。

/collection:<ProjectCollectionUrl>

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

既定では、競合の AutoResolve All が自動的に試みられます。 この既定の動作を無効にするには、このオプションを指定します。 詳細については、「Team Foundation バージョン管理の競合の解決」を参照してください。

/noprompt

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

/notes

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

  • <NoteFieldName>=<NoteFieldValue>: チェックイン メモ フィールドの値を設定します。 セミコロン (;) で区切られた field=value 式を複数指定できます。
  • @<NoteFile>: チェックイン メモ フィールドの名前および値が field=value の形式で記述されているディスク上のファイルのパスを指定します。 セミコロンで区切られたメモ タイルは、複数行にまたがることができます。次に例を示します。

    <Field1>=<Value1>;
    <Field2>=<First line of Value2>;
    <Second line of Value2>;
    <Field3>=<Value3>;

/override

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

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

/recursive

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

/saved

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

/shelveset:<shelvesetname>[;<owner>]

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

注意

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

/validate

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

注意

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

例

次の例では、c:\code\SiteApp\Main がユーザーのワークスペース内のプロジェクト コレクションにマップされたメイン フォルダーであると想定しています。

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

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

c:\code\SiteApp\Main>tf checkin

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

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

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

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

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

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