Checkin コマンド
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
TFVC checkin
コマンドは、保留中のファイルとフォルダーの変更をサーバーにチェックインします。
開発マシン上のファイルに加えたほぼすべての変更は、チェックインするまで、保留中の変更 としてワークスペースに格納されます。 変更をチェックインすると、サーバー上の 変更セット として保存されます。
checkin
コマンドは、作業をチームのコードベース にチェックインするで Visual Studio に記載されているのと同じプロセスを実行するための別のユーザー インターフェイスを提供します。
ヒント
変更を確保したり、別のタスクのためにワークスペースをクリーンアップしたりするには、Shelve コマンドを使用します。
競合によってチェックインがブロックされる場合は、解決コマンド を使用して解決できます。
マシンとユーザー アカウントに、シェルブセットを含むプロジェクト コレクションにマップされたワークスペースがない場合は、
/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]
パラメーター
パラメーター
説明
/author:<author name>
ユーザーが別のユーザーに代わって変更をチェックインできるように、保留中の変更の作成者を識別します。
CheckinOther アクセス許可が必要です。 「アクセス許可とグループの参照を参照してください。
/bypass
ゲートチェックイン要件をバイパスします。 詳細については、「ゲート チェックイン ビルド処理によって制御されるフォルダーにチェックインする」を参照してください。
/collection:<ProjectCollectionUrl>
shelveset
オプションを使用する場合、/collection
オプションは、シェルブセットを含むプロジェクト コレクションの URL を指定します。 (例: http://myserver:8080/tfs/DefaultCollection
)。
既定では、プロジェクト コレクションは、現在のディレクトリをマップするワークスペースを含むコレクションと見なされます。
/comment
次のいずれかの引数を使用して、コメントを変更セットに関連付けます。
-
"<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 つ以上のチェックイン ノートを提供します。
-
<NoteFieldName>=<NoteFieldValue>
: チェックイン ノート フィールドの値を設定します。 セミコロンで区切られた複数のfield=value
式を指定できます。 -
@<NoteFile>
: チェックイン ノート フィールドの名前と値をfield=value
形式で含む、ディスク上のファイルのユーザー指定のパス。 セミコロンで区切られたノート タイルは、次に例を示す複数の行にまたがることができます。<Field1>=<Value1>;
<Field2>=<First line of Value2>;
<Second line of Value2>;
<Field3>=<Value3>;
/override
次のいずれかの引数を使用して、チェックイン ポリシーをオーバーライドします。
-
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