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