Checkin 命令

簽入檔案或資料夾的暫止變更至伺服器。

幾乎您在開發電腦上對檔案所做的每項變更都會在您的工作區中儲存為暫存的變更直到您將它們簽入當您簽入變更時，它們會儲存為 變更集 在伺服器上。雖然 Checkin 命令提供 與Visual Studio不同的使用者介面以使用 (請參閱 將工作成果簽入小組的程式碼庫)程序完全相同。

**需求：**請參閱 Team Foundation Server 使用權限。

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 的權限。請參閱 Team Foundation Server 使用權限。
/bypass	略過閘道簽入需求。如需詳細資訊，請參閱簽入由閘道簽入建置流程所控制的資料夾。
/collection:TeamProjectCollectionUrl	如果您使用 /shelveset 選項， /collection 選項指定含有擱置集 Team 專案集合的 URL。例如 http://<伺服器名稱>:8080/tfs/DefaultCollection。 根據預設， Team 專案集合是假設為包含現在對應路徑的工作區的那項。
/comment	使用下列其中一個引數，使註解與變更集產生關聯: Comment一個關於簽入的使用者提供註解。 @comment file:磁碟上檔案的路徑中包含簽入註解。
/force	即使檔案沒有內文變動，強制在項目簽入暫止的編輯。
itemspec	指定項目的範圍設定為從使用者的工作區中簽入。您可以指定一個以上的 Itemspec 引數。如需語法資訊，請參閱 Team Foundation 版本控制命令參考。
/login:username,[password]	指定使用者帳戶以執行命令。請參閱 Team Foundation 版本控制命令參考。
/new	每個暫止的變更狀態 (如 [簽入] 對話方塊所示)，註解、關聯的工作項目類型，簽入提示和簽入原則覆寫原因，在您的 dev 機器儲存為暫止的變更，直到您簽入。在簽入之前， /new 選項會清除這項簽入中繼資料。 當您使用 /noprompt 選項，這個選項和它修改的行為不會有作用。
/noautoresolve	根據預設，系統會自動嘗試對 [全部自動解析]解決檔案衝突(請參閱)。指定這個選項會停用這個預設行為。
/noprompt	隱藏視窗和對話方塊顯示 (例如 [簽入] 對話方塊) 並將輸出資料導向至命令提示字元。請參閱 Team Foundation 版本控制命令參考。
/notes	使用下列其中一個引數，將一或多個簽入提示與變更集關聯: NoteFieldName=NoteFieldValue設定簽入註解欄位的值。您可以提供多個以分號分隔的 "field=value" 運算式。 Notefile:使用者提供路徑的檔案包含提示欄位名稱和值的鍵盤以「欄位=值」格式。例如分號分隔提示標題可以跨多行，如下所示: 欄位1=值1; 值2 欄位2=第一行 第二行 值2; 欄位3=值3;
/override	使用下列其中一個引數，覆寫簽入原則: reason:使用者提供的原因為何忽略該簽入原則。 Reasonfile:到一檔案的路徑包含使用者提供說明為何忽略簽入原則。
/recursive	以遞迴方式簽入在指定的目錄和所有子目錄中的項目。
/saved	忽略這個參數。
/shelveset:shelvesetname[;owner]	指定擱置集簽入。此選擇性的 owner 引數用於指定目前使用者所未擁有的擱置集。 注意事項 在您簽入擱置集之後，系統會將它刪除。
/validate	測試不檢查檔案的簽入是否功。系統會評估簽入原則、簽入提示和清單衝突。 注意事項 如果您沒有指定 /noprompt 選項，您必須先在 [簽入] 對話方塊選取 [簽入] 按鈕以驗證簽入。在您選擇這個按鈕後，系統不會在簽入檔案。

範例

在目前工作區中簽入所有暫止的變更

c:\code\SiteApp\Main>tf checkin

顯示 [簽入] 對話方塊，在目前工作區中的所有暫止的變更。您可以使用 [簽入] 對話方塊中選取或清除您要簽入之暫止的變更簽入，加入註解，使工作項目產生關聯，以及執行其他工作然後選取 [簽入] 按鈕，當您準備好執行時。

簽入具有註解的所有暫止的變更

c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"

在目前工作區中簽入所有暫止的變更並提供註解來協助您的小組成員了解變更的目的。

簽入至單一項目的變更，而不需使用簽入對話方塊

c:\code\SiteApp\Main>tf checkin program.cs /noprompt

註冊暫止變更至 program.cs 。[簽入] 對話方塊中不會顯示，而如果任何衝突會封鎖簽入，系統不會顯示衝突視窗。

Visual Studio 的運作

• 使用 Visual Studio將工作成果簽入小組的程式碼庫 簽入伺服器所做的變更。

秘訣

• 若要保留變更 (或許也想要為另一個工作清除您的工作區 (Client Area)，請使用 Shelve 命令。

• 如果衝突會封鎖簽入，您可以使用 Resolve Command 加以解決。

• 如果電腦和使用者帳戶沒有工作區對應至包含擱置集上的 Team 專案集合，您可以使用 /shelveset ，並 /collection 選取簽入擱置集。