Changeset 命令
更新：2007 年 11 月
顯示相關資訊並讓您對屬性 (Attribute) 進行變更；例如與變更集關聯的註解和簽入提示。
必要的使用權限
若要使用 changeset 命令，您必須針對要顯示完整資訊之變更集中的任何檔案或資料夾，將 [讀取] 權限設定為 [允許]。唯一可以修改與變更集關聯之提示和註解的使用者，是建立該變更集或具有 [修訂其他使用者的變更] 全域權限的使用者。如需詳細資訊，請參閱 Team Foundation Server 使用權限。
tf changeset [/comment:comment|@commentfile] [/server:servername]
[/notes:(“NoteFieldName”=”NoteFieldValue”|@notefile)] [/noprompt]
[changesetnumber | /latest]
參數
引數 |
描述 |
|---|---|
comment |
提供有關簽入的註解。 |
@commentfile |
指定磁碟上檔案的路徑，此檔案包含用於簽入的註解。 |
servername |
/server 選項的使用者提供值。範例：teamfoundation2。 |
NoteFieldName=NoteFieldValue |
設定簽入註解欄位的值。您可以提供多個以分號分隔的 "field=value" 運算式。 |
@notefile |
提供磁碟上檔案的路徑，此檔案包含簽入提示的欄位名稱和值，且使用 "field=value" 的格式每行顯示一筆資料。 |
changesetnumber |
辨別要檢視或修改的變更集。無法搭配 /latest 使用。 |
選項 |
描述 |
|---|---|
/comment |
使用新的變更集註解取代在簽入處理序期間所建立的註解。 |
/server |
辨別 Team Foundation Server。如果此命令是從尚未對應至工作區的目錄叫用，就會需要這個選項。 |
/notes |
提供一或多個要與變更集相關聯的簽入提示。 |
/latest |
指定最新的變更集。無法搭配 changesetnumber 使用。 |
/noprompt |
抑制任何要求您輸入的提示。 |
備註
變更集是已做為相同簽入事件的一部分認可到 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