事件
協調指令 （Team Foundation 版本控制）
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） tf reconcile 命令會比較磁碟上工作區的目前狀態與伺服器的檢視，以清除工作區或升級未加上連線的本機變更。
請參閱 預設 TFVC 許可權。
tf reconcile [itemspec]
/clean [/diff] [/noprompt] [/preview] [/recursive] [/ignore]
[/unmapped] [/exclude:itemspec1,itemspec2,...]
tf reconcile [itemspec]
/promote [/adds] [/deletes] [/diff] [/noprompt] [/preview]
[/recursive] [/noignore] [/exclude:itemspec1,itemspec2,...]
Argument
說明
<itemspec>
識別要套用命令的 reconcile 檔案或資料夾。 如果省略，則會包含所有適當的專案。 如需 TFVC 如何剖析 itemspec 以判斷哪些專案在範圍內的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
注意
您可以指定多個 itemspec 自變數。
選項
說明
/clean
更新 磁碟上的本機專案，以符合伺服器的結構。 拿掉版本控制中不存在的專案，並新增磁碟上遺漏但存在於版本控制中的專案。
/promote
將本機檔案變更升階至版本控制。 將本機建立的專案新增至版本控制，類似於 tf add，並移除本機刪除的專案。
注意
搭配 /noprompt使用 時，請指定 /adds 和/或 /deletes 。
/adds
將本機新增的檔案和資料夾升階至版本控制。
注意
只能搭配 /promote 使用。
/deletes
將已刪除的檔案和資料夾升階為版本控制。
注意
只能搭配 /promote 使用。
/exclude
忽略此選項中指定的逗號分隔專案。
注意
這個選項會在 /ignore交集時覆寫、 /noignore和 /unmapped 選項。
/unmapped
覆寫預設值，並清除未對應的和遮蓋的專案。 根據預設，未對應的專案和遮蓋專案不會受到 /clean 命令的影響。 如需詳細資訊，請參閱 對應 （workspace）。
注意
只能搭配 /clean 使用。
/diff
使用 MD5 哈希比較專案與原始檔控制。 使用此選項來偵測與工作區版本不同的專案，但仍有其只讀位集 （+R）。
/preview
顯示會發生的情況，而不實際執行 reconcile 作業。
/ignore
覆寫預設值，且不會變更忽略的專案。 根據預設， /clean 會根據目前的伺服器狀態更新所有專案，包括版本控制忽略的專案。 使用此選項可避免變更忽略的專案。
您可以使用 .tfignore 檔案來設定忽略哪些專案。 如需詳細資訊，請參閱 自定義哪些檔案版本控制會忽略。
注意
只能搭配 /clean 使用。
/noignore
覆寫預設值，並升級忽略的專案。 根據預設， /promote 會升級版本控制所忽略專案以外的所有專案。 使用此選項也可以升級忽略的專案。 這個選項類似於 /noignore 在命令中使用 tf add 。
注意
只能搭配 /promote 使用。
/recursive
協調特定目錄和子目錄中的專案。
/noprompt
隱藏視窗和對話框的顯示，並將輸出數據重新導向至命令提示字元。 請參閱 使用Team Foundation版本控制命令。
您可以使用 reconcile 命令來同步處理本機工作區狀態與伺服器的狀態。
- 使用
/clean來根據伺服器的狀態更新本機工作區。 - 使用
/promote將新增和刪除的項目升級為版本控制中的擱置變更。
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用Team Foundation版本控制命令。
下列範例會開啟 [Visual Studio 清理工作區 ] 對話方塊，以便指定應該從伺服器刪除或重新下載的本機專案。
tf reconcile /clean
下列範例會清除版本控制所忽略專案以外的所有本機專案。
tf reconcile /clean /ignore
下列範例會清除所有本機專案，包括未對應的專案和遮蓋專案。
tf reconcile /clean /unmapped
下列範例會清除除了file1.txt和 dir1 以外的所有專案及其所有內容，而且不會顯示 [清除工作區] 對話方塊。
tf reconcile /clean /noprompt /recursive /exclude:file1.txt,dir1
下列範例會開啟 [Visual Studio 升級候選變更 ] 對話方塊，以便指定哪些項目應該升階為擱置中的變更。
tf reconcile /promote
下列範例會升級所有專案，包括版本控制忽略的專案，但myLib.dll檔案除外。
tf reconcile /promote /noignore /exclude:myLib.dll
下列範例會將所有本機建立的專案新增至版本控制暫止變更，而不需開啟 [ 升階候選變更 ] 對話方塊。 此命令類似於 tf add /noprompt 命令。
tf reconcile /promote /adds /noprompt
下列範例會將所有本機刪除的專案新增至版本控制暫止變更，而不需開啟 [ 升階候選變更 ] 對話方塊。
tf reconcile /promote /deletes /noprompt