Rename 命令 (Team Foundation 版本控制)

更新：2007 年 11 月

rename 命令變更檔案或資料夾的名稱或路徑。您可以使用 rename 命令或別名 move 或 ren 將檔案或資料夾移至新位置。

注意事項：
在您執行簽入作業後，這個命令的結果才會反映在 Team Foundation 版本控制伺服器中。如需詳細資訊，請參閱 HOW TO：簽入暫止的變更。

必要的使用權限

若要使用 rename 命令，您必須將 [簽出] 權限設定為 [允許]。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

tf rename [/lock:(none|checkout|checkin)] olditem newitem

參數

引數	描述
olditem	要重新命名的檔案或資料夾的原始名稱和路徑。您可以指定例如 C:\myfiles\314.cs 的本機工作區路徑，或例如 $/myfiles/314.cs 的 Team Foundation 版本控制伺服器路徑。
newitem	檔案或資料夾的新名稱。您可以使用這個指定不同的本機或 Team Foundation 版本控制伺服器路徑位置。

選項	描述
/lock	包含這個選項以防止其他使用者簽入或簽出指定的項目。如果沒有指定這個選項，項目的現有鎖定狀態便不會變更。如需詳細資訊，請參閱瞭解鎖定類型。鎖定選項： None 沒有套用任何鎖定。 Checkin 雖然其他使用者可以簽出指定的項目，不過在您透過執行簽入而解除鎖定以前，他們無法將修訂項目簽入鎖定的檔案。如果任何其他使用者已經鎖定其中一個指定的項目，則鎖定作業就會失敗。 Checkout 避免其他使用者在您藉由執行簽入而釋出鎖定前，簽入或簽出任何指定的項目。如果有任何其他使用者已鎖定任何的指定項目，鎖定作業就會失敗。

/lock

包含這個選項以防止其他使用者簽入或簽出指定的項目。如果沒有指定這個選項，項目的現有鎖定狀態便不會變更。如需詳細資訊，請參閱瞭解鎖定類型。

鎖定選項：

None 沒有套用任何鎖定。
Checkin 雖然其他使用者可以簽出指定的項目，不過在您透過執行簽入而解除鎖定以前，他們無法將修訂項目簽入鎖定的檔案。如果任何其他使用者已經鎖定其中一個指定的項目，則鎖定作業就會失敗。
Checkout 避免其他使用者在您藉由執行簽入而釋出鎖定前，簽入或簽出任何指定的項目。如果有任何其他使用者已鎖定任何的指定項目，鎖定作業就會失敗。

您可以使用 tf 命令列公用程式的 rename 命令，移除或重新命名工作區中的版本控制項目。透過指定萬用字元 (Wildcard Character)，使用 rename 命令來移動多個檔案。您只能從命令列重新命名多個版本控制檔案或資料夾。

使用重新命名執行下列事項：

將 olditem重新命名為 newitem，例如 tf rename 314.cs 315.cs。
藉由提供路徑與 olditem 的不同的 newitem，將 olditem 移到 Team Foundation 版本控制伺服器中的新位置，例如：** **tf rename 314.cs ..\newdir\314.cs。

如果提供指定不存在資料夾的 newitem，rename 命令會建立目的資料夾。如果 newitem 是資料夾，olditem 就會成為 newitem 的子系。

如果有以下情況，就無法重新命名項目：

您可以將暫止簽入時已加入同名的其他檔案的項目重新命名，但無法將已經分支但尚未簽入的項目重新命名。當您重新命名具有暫止編輯的檔案時，編輯會予以保留。

在未先變更對應的情況下，無法重新命名明確對應的項目。例如，如果工作資料夾 $/ProjectX/MyApp 對應至 c:\MyApp，您便無法重新命名 MyApp。您可以重新命名 MyApp 之下的項目，但不包含 MyApp 本身。

如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。

下列範例將 314.c 的名稱變更為 1254.c。

c:\projects>tf rename  314.c  1254.c

下列範例將 314.c 重新命名為 1254.c，並將其移到 newdir 資料夾。

c:\projects>tf rename 314.c ..\newdir\1254.c

下列範例會將 Form1.vb 的名稱變更為 MainPage.vb，並對其套用鎖定。

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin