Checkin 命令

發行項
04/04/2024

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 選項來簽入擱置集。

必要條件

預設 TFVC 許可權

語法

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

Share via