Changeset コマンド

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

Visual Studio 2019 | Visual Studio 2022

変更セットに関連付けられているコメントやチェックイン メモなどの属性に関する情報を表示し、それを変更できます。

前提条件

changeset コマンドを使用するには、全情報を表示する変更セット内のファイルまたはフォルダーに対して、読み取りアクセス許可が [許可] に設定されている必要があります。 変更セットに関連付けられているメモとコメントを変更できるのは、変更セットを作成したユーザー、または他のユーザーの変更を編集グローバル アクセス許可を持つユーザーのみです。

詳細については、「既定の TFVC アクセス許可」を参照してください。

構文

tf changeset [/comment:("comment"|@commentfile)] 
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]] 
[changesetnumber | /latest][/login:username,[password]]

パラメーター

引数

Argument 説明
comment チェックインに関するコメントを指定します。
@<commentfile> チェックインに使用されるコメントを含むディスク上のファイルのパスを指定します。
<NoteFieldName>=<NoteFieldValue> チェックイン メモ フィールドの値を設定します。 セミコロン (;) で区切られた field=value 式を複数指定できます。
@<notefile> チェックイン メモ フィールドの名前および値が field=value の形式で 1 行に 1 つずつ含まれているディスク上のファイルのパスを指定します。
<TeamProjectCollectionUrl> 情報を表示するか、属性を変更する対象の変更セットを含むプロジェクト コレクションの URL (例: http://myserver:8080/tfs/DefaultCollection)。
<username> /user オプションに値を指定します。 この引数は、Domain\username または username の形式で指定できます。
<changesetnumber> レビューまたは変更の対象の変更セット特定します。 /latest とは使用できません。

オプション

オプション 説明
/comment チェックイン プロセス中に作成された変更セット コメントを新しいコメントに置き換えます。
/notes 変更セットに関連付ける 1 つ以上のチェックイン メモを指定します。
/latest 最新の変更セットを指定します。 <changesetnumber> とは使用できません。
/noprompt ユーザーからの入力を求めるプロンプトが表示されないようにします。
/collection プロジェクト コレクションを指定します。
/login Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。

解説

"変更セット" は、同じチェックイベントの一部として Team Foundation バージョン管理サーバーにコミットされたファイルとフォルダーのリビジョンのセットです。 詳細については、変更セットの操作に関する記事を参照してください。

changeset コマンドを使用して、変更セットの属性を表示し、そのプロパティを変更できます。 history コマンドを使用して、情報を取得する変更セットを決定できます。 詳細については、「履歴コマンド」を参照してください。

tf コマンド ライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。

次の例は、変更セット 8675309 に関する詳細情報を Visual Studio の [変更セット 8675309 の詳細 - ソース ファイル] ダイアログ ボックスに編集可能な形式で表示し、既存のコメントを This is a new comment に置き換えます。

c:\projects>tf changeset /comment:"This is a new comment." 8675309

コマンドを入力した後に、Visual Studio の [変更セット 8675309 の詳細 - ソース ファイル] ダイアログ ボックスで、[保存] を選択して、コメントを変更セットに関連付けます。

次の例は、変更セットに関連付ける 2 つのチェックイン メモを指定します。

c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309

次の例は、変更セットに関連付ける値と名前にスペースを含む 2 つのチェックイン メモを指定します。

c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309

次の例は、ファイル "notes.txt" に含まれているチェックイン メモを変更セット 8675309に関連付けます。

c:\projects>tf changeset /notes:@notes.txt 8675309

ここで、"notes.txt" の形式には次のようなものが考えられます。

field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;

次の例は、変更セット 8675309の既存のコメントを置き換え、コマンド プロンプト ウィンドウにその変更セットに関する情報を表示します。 この例は、Visual Studio の [変更セット] ダイアログ ボックスを開きません。

c:\projects>tf changeset /comment:"This is an automatically generated comment." /noprompt 8675309

次の例は、コマンド プロンプト ウィンドウに変更セット 8675309 に関する編集できない情報を表示します。

c:\projects>tf changeset 8675309 /noprompt

サンプル出力:

Changeset: 8675309
User: DOMAIN\JohnG
Date: 01/21/2004 21:03:45
Comment:  This check-in fixes issues in several features.  I also refactored some items in buf.c into a new file named bif.c because buf.c was too hard to parse.
Items:
    $/baz/proj/bif.c           Added
    $/baz/proj/buf.c          Modified, Renamed
Work Items:
    34527     The "Access Denied" message isn't descriptive enough.
    35628     The UI flickers when I press the '8', 'y', 'Ctrl', and 'End' buttons at the same time.
Check-in Notes:
    Code Reviewer:  ShellM
    Performance Reviewer: ShellM
    Security Reviewer: ShellM