命令列語法 (Team System)

發行項
08/21/2008

更新：2007 年 11 月

tf.exe 命令列公用程式的語法。

tf command item [/options]

本主題將說明文件慣例、命令捷徑、特殊命令列字元以及 Team Foundation 專用的參數 (versionspec 和 itemspec)。

文件慣例

[/Brackets] 表示完成命令非必要的選項。不帶有括號的項目表示完成作業必要的參數。例如，在下列命令中，itemspec 是必要項而 /recursive 是選擇項：

語法範例：c:\projects>tf getitemspec [/recursive]

實際命令：c:\projects>tf get c:\projects /recursive

替代命令：c:\projects>tf get /recursive

在替代命令範例中，Team Foundation 會推斷出您想要取得目前目錄 (c:\projects) 及其所有子資料夾的內容。因此，即使 itemspec 參數是必要項，您也不一定要輸入此參數。

當兩個以直線字元 (|) 分隔的選項放在一組括號中，您就可以指定其中一個選項，但不能同時指定這兩個選項。例如，tf Changeset [/comment:comment|@commentfile] 表示您可以在 /comment: 選項後面輸入變更集的註解，或者 (|) 也可以使用 **@**commentfile 語法來指定内含您想使用的註解之檔案的路徑。不過，您無法同時指定 comment 和 commentfile。

在語法範例中，italic 項目表示參數，您必須以執行命令的實際字元取代這些項目。粗體項目則是您逐字納入的選項。例如：

語法範例：tf shelvesetsshelvesetname [/recursive]

實際命令：c:\projects>tf shelvesets BuddyTest_23

特殊命令列字元

您可以使用 “@” 字元 (即「命令檔參數」(Command File Switch)) 來同時執行一組 Team Foundation 命令。從命令提示字元、命令檔或在批次或指令碼檔中使用命令列參數的主要優點是，使用命令列參數的執行速度會比執行個別命令的速度快。如需詳細資訊，請參閱命令列選項。

命令捷徑和別名

下列定義的命令捷徑和別名可支援 tf 命令列公用程式：

del = delete
diff = difference
edit = checkout
hist = history
perm = permission
prop = properties
ren = rename
rename = move
stat = status
undel = undelete

如需這些命令的詳細資訊，請參閱 Tf 命令列公用程式命令。

Team Foundation 如何剖析項目規格和版本規格

項目規格路徑

「項目規格」(Itemspec，項目規格的縮寫) 是指 Team Foundation 解析為單一項目或項目集的一個或多個字元，這些項目會參考對應至工作區或版本控制伺服器的檔案系統或 UNC 路徑。

您可以針對接受項目規格的所有 Team Foundation 命令，指定本機檔案路徑 (例如 c:\projects)、UNC 路徑 (例如 \\myshare\projects) 或伺服器路徑 (例如 $/projects/myfiles)。

若為本機路徑，您可以提供相對路徑。例如，如果您目前的目錄是 c:\projects，而且想要簽出 projects 資料夾之子目錄中的所有項目，就可以輸入 tf checkout .\* /recursive。

注意事項：
您可以在 Team Foundation 版本控制命令中使用萬用字元 (Wildcard Character)，例如：*、? 和 #。

如果您的項目規格指定伺服器路徑，此路徑就必須是完整的路徑。例如，您無法使用 ./* 做為項目規格，簽出 $/projects 資料夾底下的所有項目。

版本規格

「版本規格」會指定您想要使用之項目的版本。您可以在命令中指定版本，方法是納入版本規格做為版本選項的一部分 (例如 /version:C1256)，或是將版本規格附加至檔案名稱並加上分號 (例如 filename;Lmylabel)。

請使用下列一個或多個模式來指定版本。

版本規格	說明
Changeset	屬於變更集編號 changeset 的版本。範例：C1256。
Llabel	屬於標籤 label 的版本。範例：Lmylabel。
Dyyyy-mm-ddTxx:xx -或- Dmm/dd/yyyy -或- 任何 .NET Framework 支援的格式。 -或- 本機電腦的任何日期格式。	任何可由 .NET Framework 方法剖析的日期和時間格式。範例：D2008-01-21T16:00。如需支援的日期和時間格式的詳細資訊，請參閱 .NET Framework 類別庫中的 DateTime 結構 (英文)。
W	上次使用 get 命令擷取至工作區中的版本。
T	最新的修訂。

當您使用 History、Difference 或 Merge 命令時，可以透過以波狀符號 (~) 分隔版本的方式，指定版本範圍。請參閱下列範例，了解如何透過波狀符號分隔版本的方式來指定範圍。

若只要檢視 Form1.cs 檔案中變更集 137 的歷程。

語法範例：**tf history /version:**C137~C137

若要取得 form.cs 檔案的變更集 C123 和 C125 之間的差異。

語法範例：tf difference/versionC123~C125 form1.cs.

若要將第一個變更集至變更集 C125 的所有版本合併至 branch2。

語法範例：**tf merge/version:**C125 branch1 branch2

請參閱

共用方式為