Get 命令
更新:2007 年 11 月
從 Team Foundation Server 擷取檔案的唯讀複本到工作區 (Workspace),並在磁碟上建立資料夾以包含該檔案複本。
必要的使用權限
若要使用 get 命令,您必須將每一個已擷取項目的 [讀取] 權限設定為 [允許],而且您必須擁有目標工作區或 [管理工作區] 權限。如需詳細資訊,請參閱 Team Foundation Server 使用權限。
tf get itemspec [/version:versionspec] [/all] [/overwrite] [/force]
[/preview] [/recursive] [/remap] [/noprompt]
參數
引數 |
說明 |
---|---|
Itemspec |
要擷取的檔案或資料夾。如果沒有提供 itemspec,Team Foundation Server 會執行目前工作區的遞迴 get 作業。 |
Versionspec |
/version 選項的使用者提供值。如需 Team Foundation Server 如何剖析版本規格以便判斷哪些項目位於範圍內的詳細資訊,請參閱命令列語法 (Team System)。 |
選項 |
說明 |
---|---|
/version |
選擇性版本規格。versionspec 是您要擷取之項目的版本。您可以藉由下列各項指定版本:
|
/all |
強制擷取所有檔案,而不只是過時的檔案。 |
/overwrite |
覆寫尚未簽出的可寫入檔案。 |
/force |
結合 /all 和 /overwrite。 |
/preview |
顯示可能發生的狀況,而不需實際執行 Get 作業。 |
/recursive |
以遞迴方式擷取符合 itemspec 的所有項目。 |
/remap |
僅適用於 Microsoft Visual Studio Team System 2008 Team Foundation Server Service Pack 1 版。 針對本機磁碟上的內容與您要從版本控制分支下載之內容相同的所有項目,更新其本機重新對應分支的資料庫參考。 |
/noprompt |
隱藏在進行此作業期間會顯示的任何對話方塊。 |
備註
get 命令會將項目從伺服器擷取到工作區中。如果沒有指定版本,就會擷取最新的伺服器版本。在執行 get 作業後,Team Foundation Server 會從伺服器刪除在本機標記要刪除的任何檔案,以及上一次工作區與伺服器同步 (Synchronize) 之後簽入的任何檔案。已在伺服器上重新命名或移動的檔案會在磁碟上重新配置,以符合對伺服器所做的變更。在伺服器上已重新命名或移動的檔案也會在本機工作區中移動,以符合對伺服器所做的變更。
get 命令不會覆寫已在本機工作區目錄中簽出的檔案。當您對已在工作區內簽出的項目發出 get 命令,而且伺服器的版本已經變更時,系統會提示您解決工作區與伺服器版本之間的檔案衝突。如需詳細資訊,請參閱 Resolve 命令。
如果工作區版本與要求的伺服器版本相同,而且您想要取代磁碟上的檔案,請使用 /all 選項。
使用 /overwrite 選項,以指定的伺服器版本強制覆寫可寫入的目前工作區版本。
使用 /force 選項,以最新的伺服器版本覆寫工作區內所有簽出的項目。您也可以使用 /force 選項覆寫特定版本。
使用 /preview 選項,檢視下一次 get 作業期間將會發生的變更。
注意事項: |
---|
請經常使用 get 命令來保持工作區的最新狀態,以便快速解決您的專案版本和伺服器的專案版本之間的差異。 |
如需如何尋找 tf 命令列公用程式的詳細資訊,請參閱 Tf 命令列公用程式命令。
搭配使用 Get 與 /remap 選項
/remap 選項可節省將本機資料夾對應至新分支或其他分支時的下載時間。例如:
您將 $/branch1 對應至電腦上的 D:\branch。
您執行 tf get 從 $/branch1 取得所有項目的複本,並放入本機資料夾。
您變更 $/branch1 的對應,然後將 $/branch2 對應到先前對應為 $/branch1 的本機資料夾 (D:\branch)。
您執行 tf get 並指定 /remap 選項,只下載 $/branch2 中與本機資料夾上 $/branch1 (D:\branch) 之內容不同的內容。
注意事項: |
---|
必須安裝 Microsoft Visual Studio Team System 2008 Team Foundation Server Service Pack 1 版才能使用這項功能。 |
範例
下列範例會從伺服器擷取最新的 314.cs 版本。如果您有針對 314.cs 的暫止變更,Team Foundation Server 會提示您解決所有衝突。
C:\projects>tf get 314.cs
下列範例會從伺服器擷取 1256.cs 的版本 8。
注意事項: |
---|
使用 1256.cs;8 與使用 1256.cs;C8 相同。依預設值,如果只在分號後指定數字,就會使用變更集版本。 |
C:\>tf get 1256.cs;8
下列範例會從伺服器資料夾和子資料夾將所有取消隱匿項目的最新版本擷取到 C:\projects 目錄,並在必要的位置建立本機資料夾。如需如何隱匿和取消隱匿資料夾的詳細資訊,請參閱 Workfold 命令。
C:\projects>tf get
下列範例提供其他方式來擷取使用變更集 1999 簽入的 1256.cs 版本。
c:\projects>tf get /version:C1999 1256.cs
- 或 -
c:\projects>tf get 1256.cs;C1999
下列範例根據建立變更集 271 時項目在伺服器中的存在方式,從伺服器擷取所有取消隱匿項目的版本。
c:\projects>tf get /version:C271
下列範例會擷取 build42,標記為 "build42"。這樣只要沒有暫止變更,就會比對工作區與該標籤。不在標籤中的任何檔案都會從本機磁碟中移除。
c:\projects>tf get /version:Lbuild42
下列範例會從伺服器擷取特定日期和時間的版本。
c:\projects>tf get /version:D2008-01-21T16:00
請參閱
工作
逐步解說:從命令列使用 Team Foundation 版本控制