Checkin 命令
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
TFVC checkin 命令會檢查您暫止的檔案和資料夾變更至伺服器。
您在開發計算機上對檔案所做的幾乎每一項變更都會儲存在工作區中，以 擱置的變更，直到您存回。 當您簽入變更時，它們會儲存為伺服器上的 變更集。
checkin 命令會提供不同的使用者介面，以在 將工作簽入小組的程式代碼基底中針對 Visual Studio 所記載的相同程式。
提示
若要為另一項工作保留變更或清除工作區，請使用 Shelve 命令。
如果衝突封鎖您的簽入，您可以使用 解決命令 來解決它們。
如果計算機和使用者帳戶沒有對應至包含擱置集的專案集合的工作區，您可以使用
/shelveset和/collection選項來簽入擱置集。
先決條件
語法
tf checkin [/author:author name] [/comment:("comment"|@comment file)]
[/noprompt] [/notes:("Note Name"="note text"|@notefile)]
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/force] [/noautoresolve] [/login:username,[password]] [/new]
tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]
參數
參數
說明
/author:<author name>
識別暫止變更的作者，讓使用者可以代表其他使用者簽入變更。
需要 CheckinOther 許可權。 請參閱 權限與群組參考。
/bypass
略過閘道簽入需求。 如需詳細資訊，請參閱 簽入受網關簽入建置程式控制的資料夾。
/collection:<ProjectCollectionUrl>
如果您使用 [shelveset] 選項，/collection 選項會指定包含擱置集的專案集合 URL。 例如： http://myserver:8080/tfs/DefaultCollection 。
根據預設，專案集合會假設為包含對應目前目錄之工作區的專案集合。
/comment
使用下列其中一個自變數，將批注與變更集產生關聯：
-
"<comment>"：使用者提供的簽入批注。 -
@<comment file>：磁碟上檔案的路徑，其中包含簽入的批注。
/force
即使檔案中沒有任何內容變更，仍強制簽入具有擱置編輯的專案。
<itemspec>
指定要從使用者工作區簽入的項目範圍。 您可以指定多個 itemspec 自變數。 如需語法，請參閱 使用 Team Foundation 版本控制命令。
/login:<username>[,<password>]
指定要執行命令的用戶帳戶。 請參閱 使用 Team Foundation 版本控制命令。
/new
每個暫止變更的選取狀態，如 [簽入] 對話框中所示。 批注、相關聯的工作專案、簽入附注和簽入原則覆寫原因會儲存在開發計算機上，直到您簽入這些變更為止。
/new 選項會在您簽入之前清除此簽入元數據。 當您使用 [/noprompt] 選項時，此選項及其修改的行為沒有任何作用。
/noautoresolve
根據預設，系統會自動嘗試 AutoResolve All 衝突。 指定此選項以停用此預設行為。 如需詳細資訊，請參閱 解決Team Foundation版本控制衝突。
/noprompt
隱藏視窗和對話框的顯示，例如 簽入 對話框，並將輸出數據重新導向至命令提示字元。 請參閱 使用 Team Foundation 版本控制命令。
/notes
提供一或多個簽入附註，以使用下列其中一個自變數與變更集產生關聯：
-
<NoteFieldName>=<NoteFieldValue>：設定簽入記事欄位的值。 您可以提供多個分號分隔field=value表示式。 -
@<NoteFile>：磁碟上檔案的使用者提供路徑，其中包含field=value格式的簽入記事域名和值。 分號分隔的記事磚可以跨越多行，例如：<Field1>=<Value1>;<Field2>=<First line of Value2>;<Second line of Value2>;<Field3>=<Value3>;
/override
使用下列其中一個自變數覆寫簽入原則：
-
reason：使用者提供簽入原則被忽略的原因。 -
reasonfile：檔案的路徑，其中包含使用者提供之簽入原則被忽略的原因描述。
/recursive
以遞歸方式檢查指定目錄和任何子目錄中的專案。
/saved
忽略此參數。
/shelveset:<shelvesetname>[;<owner>]
指定要簽入的擱置集。 選擇性 owner 自變數會指定目前用戶不擁有的擱置集。
備註
簽入擱置集之後，系統會將其刪除。
/validate
測試簽入是否成功，而不存回檔案。 系統會評估簽入原則、簽入筆記，以及列出衝突。
備註
如果您沒有指定 [/noprompt] 選項，您必須選取 [簽入] 對話框中的 [ 簽入] 按鈕，以驗證簽入。 選取此按鈕之後，系統不會簽入檔案。
範例
下列範例假設 c:\code\SiteApp\Main 是對應至使用者工作區中專案集合的主要資料夾。
簽入目前工作區中的所有擱置變更
下列命令會顯示 [簽入 ] 對話框，其中會顯示目前工作區中的所有暫止變更。 您可以使用 [簽入] 對話框來選取或清除您要簽入的擱置變更、新增批注、建立工作項目關聯，以及執行其他工作，然後在準備好繼續時，選擇 [簽入] 按鈕。
c:\code\SiteApp\Main>tf checkin
使用批注簽入所有擱置的變更
下列範例會檢查目前工作區中所有擱置中的變更，並提供批注來協助小組成員了解變更的目的。
c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"
簽入單一項目的變更，而不使用 [存回] 對話方塊
下列範例會檢查暫止 program.cs的變更。 不會顯示 [簽入] 對話方塊，如果有任何衝突封鎖簽入，系統就不會顯示衝突視窗。
c:\code\SiteApp\Main>tf checkin program.cs /noprompt