共用方式為


Changeset 命令

顯示相關資訊並讓您對屬性進行變更,例如與變更集關聯的註解和簽入提示。

必要的使用權限

若要使用 changeset 命令,您必須針對要顯示完整資訊之變更集中的任何檔案或資料夾,將 [讀取] 權限設定為 [允許]。 唯一可以修改與變更集關聯之提示和註解的使用者,是建立該變更集或具有 [修訂其他使用者的變更] 全域權限的使用者。 如需詳細資訊,請參閱Team Foundation Server 使用權限

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

參數

引數

描述

comment

提供有關簽入的註解。

@commentfile

指定磁碟上檔案的路徑,此檔案包含用於簽入的註解。

NoteFieldName=NoteFieldValue

設定簽入註解欄位的值。 您可以提供多個以分號分隔的 "field=value" 運算式。

@notefile

提供磁碟上檔案的路徑,此檔案包含簽入提示的欄位名稱和值,且使用 "field=value" 的格式每行顯示一筆資料。

TeamProjectCollectionUrl

Team 專案集合的 URL (例如 http://myserver:8080/tfs/DefaultCollection),該集合包含您要為其顯示相關資訊或修改屬性的變更集。

username

提供 /user 選項的值。 您可以將此引數指定成 Domain\ UserName 或 UserName 的格式。

changesetnumber

辨別要檢視或修改的變更集。 無法搭配 /latest 使用。

選項

描述

/comment

使用新的變更集註解取代在簽入處理序期間所建立的註解。

/notes

提供一或多個要與變更集相關聯的簽入提示。

/latest

指定最新的變更集。 無法搭配 changesetnumber 使用。

/noprompt

抑制任何要求您輸入的提示。

/collection

指定 Team 專案集合。

/login

指定使用者名稱和密碼,以便透過 Visual Studio Team Foundation Server 驗證使用者。

備註

「變更集」(Changeset) 是已做為相同簽入事件的一部分認可到 Team Foundation 版本控制伺服器的一組檔案和資料夾修訂。 如需詳細資訊,請參閱使用變更集

您可以使用 changeset 命令檢視變更集的屬性 (Attribute),並修改變更集的屬性 (Property)。 您可以使用 History 命令判斷要對其取得相關資訊的變更集。 如需詳細資訊,請參閱 History 命令

如需其他 Team Foundation 命令的連結,內容提供 Team Foundation 版本控制伺服器中項目與對應至此伺服器之所有工作區的詳細資訊,請參閱可取得資訊的命令

如需如何尋找 tf 命令列公用程式的詳細資訊,請參閱 Tf 命令列公用程式命令

範例

下列範例在 [變更集] 對話方塊中,以可編輯的格式顯示變更集 8675309 的詳細資訊,並使用 "This is a new comment" 取代現有的註解。 

按下 ENTER 鍵之後,[變更集 <changeset number> - 原始程式檔的詳細資料] 對話方塊隨即出現。 按一下 [儲存] 使註解與變更集產生關聯。

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

下列範例提供兩個與變更集關聯的簽入提示。

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

下列範例提供兩個與變更集關聯的簽入提示,其中在值和名稱中都包含空格。

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 的現有註解,並在 [命令提示字元] 視窗中顯示有關變更集的資訊。 此範例並不會啟動 [變更集] 對話方塊。

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 is not 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

請參閱

參考

Checkin 命令

簽出和編輯命令

Shelve 命令

History 命令

Configure 命令

概念

使用變更集

其他資源

Tf 命令列公用程式命令