Add 命令
將檔案和資料夾從本機檔案系統位置加入至 Team Foundation 版本控制的伺服器。
.gif "注意事項") 注意事項 |
|---|
在您執行簽入作業後，這個命令的結果才會反映在 Team Foundation 版本控制 伺服器中。 如需詳細資訊，請參閱 簽入暫止的變更。 |
必要的使用權限
若要使用 add 命令，您必須擁有工作區，並且新項目上層資料夾的 [簽出] 權限必須設定為 [允許]。 如果您使用 /lock:checkout 或 /lock:checkin，您的 [鎖定] 使用權限也必須設定為 [允許]。 如需詳細資訊，請參閱Team Foundation Server 使用權限。
tf add itemspec [/lock:(none|checkin|checkout)] [/type:filetype]
[/noprompt] [/recursive] [/login:username,[password]]
參數
引數 |
描述 |
|---|---|
itemspec |
識別要加入的檔案或資料夾。 如需 Team Foundation 如何剖析 itemspecs 以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (版本控制)。 注意事項
您可以指定一個以上的 Itemspec 引數。
|
filetype |
用於 / 類型選項。 如需詳細資訊，請參閱管理檔案類型。 |
username |
提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。 |
選項 |
描述 |
|---|---|
/type |
覆寫檔案類型對應，並將檔案加入至使用指定之類型的 Team Foundation 版本控制伺服器。 如需詳細資訊，請參閱管理檔案類型。 檔案類型偵測是根據檔案第一個 KB 的內容進行偵測。 |
/lock |
指定鎖定類型或移除項目的鎖定。 鎖定選項：
|
/noprompt |
抑制任何要求您輸入的提示。 |
/recursive |
在指定的目錄或任何子目錄中加入所有項目。 |
/login |
指定使用者名稱和密碼，以便透過 Visual Studio Team Foundation Server 驗證使用者。 |
備註
將項目加入至版本控制之前，必須設定本機工作區並建立工作資料夾對應。
Add 是暫止的變更命令；它會排程指定的項目，以在暫止工作區的簽入作業之後加入 Team Foundation 版本控制伺服器。 若要執行暫止的變更命令，目前的目錄必須對應到工作區以及它對應的 Team Foundation 版本控制伺服器。
使用 Add 命令將新項目加入至版本控制時，在您簽入最新的工作區變更之前，該項目實際上不會加入至 Team Foundation 版本控制伺服器， 而是加入至目前工作區的暫止變更清單。 若要將暫止的加入項目認可到 Team Foundation 版本控制伺服器，可以直接簽入加入的檔案，或在本機工作區中簽入所有暫止的變更。 如果擔心其他使用者可能會在您簽入暫止的變更之前，將與您的暫止加入項目同名的檔案或資料夾加入至 Team Foundation 版本控制伺服器，則可以使用 /lock 選項與 Checkout 參數以防止上述情形。 如需詳細資訊，請參閱 簽入暫止的變更。
如果使用 tf add /teamproject/projects/math/314.cs 將 314.cs 加入至版本控制，在您簽入變更之前，會將每一個不存在的資料夾都視為擱置的新增項目。 簽入變更時，如果指定路徑中的任何資料夾 (/teamproject、/teamproject/projects 或 /teamproject/projects/math) 都不在 Team Foundation 版本控制伺服器中，Team Foundation 就會為您建立這些資料夾。
您可以使用 Add 命令建立 Team Foundation 版本控制伺服器的初始檔案結構。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
範例
下列範例會將 314.c 和 1256.c 檔案加入至與工作資料夾 C:\Pi 相關聯的工作區的暫止變更清單。
c:\pi>tf add 314.cs 1256.c
下列範例會將目前的目錄以及任何子目錄中的所有 C# 程式碼檔案 (.cs) 加入至目前工作區的暫止加入項目清單。
c:\projects>tf add *.cs /recursive
下列範例將目前的目錄及其所有子資料夾中所有名稱包含 "hello" 的檔案和資料夾，加入至 c:\projects 所對應至的工作區的暫止加入項目清單。
c:\projects>tf add *hello* /recursive