命令列語法 (版本控制)

發行項
08/12/2011

tf (Team Foundation 命令列公用程式) 的語法命令如下所示：

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。

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

語法範例：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 嘗試解析為可定址項目或項目集合。

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

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

秘訣
您可以在 Team Foundation 版本控制命令中使用萬用字元，例如：* 和 ?。

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

版本規格

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

請使用下列任何一種模式來指定版本。

版本規格	描述
變更集	屬於變更集編號 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 命令下載至您的工作空間的版本。
Wworkspacename;workspaceowner	最近以 get 命令下載至指定工作空間的版本。範例：WResolveRIConflicts;AKerry
T	最新版本。

當您使用 History 或 Difference 命令時，可以透過以波狀符號 (~) 分隔版本的方式，指定版本的範圍。

請參閱