Rename 命令 (Team Foundation 版本控制)
rename 命令變更檔案或資料夾的名稱或路徑。 您可以使用 rename 命令或別名 move 或 ren 將檔案或資料夾移至新位置。
.gif "注意事項") 注意事項 |
|---|
在您執行簽入作業後，這個命令的結果才會反映在 Team Foundation 版本控制伺服器中。 如需詳細資訊，請參閱 簽入暫止的變更。 |
必要的使用權限
若要使用 rename 命令，您必須將 [簽出] 權限設定為 [允許]。 如需詳細資訊，請參閱Team Foundation Server 使用權限。
tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem
參數
引數 |
描述 |
|---|---|
olditem |
要重新命名的檔案或資料夾的原始名稱和路徑。 您可以指定例如 C:\myfiles\314.cs 的本機工作區路徑，或例如 $/myfiles/314.cs 的 Team Foundation 版本控制伺服器路徑。 |
newitem |
檔案或資料夾的新名稱。 您可以使用這個指定不同的本機或 Team Foundation 版本控制伺服器路徑位置。 |
username |
提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。 |
選項 |
描述 |
|---|---|
/lock |
包含這個選項以防止其他使用者簽入或簽出指定的項目。 如果沒有指定這個選項，項目的現有鎖定狀態便不會變更。 如需詳細資訊，請參閱認識鎖定類型。 鎖定選項：
|
/login |
指定使用者名稱和密碼，以便透過 Visual Studio Team Foundation Server 驗證使用者。 |
備註
您可以使用 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 的子系。
如果有以下情況，就無法重新命名項目：
在簽入同一工作區之前，您已經刪除該項目。
新名稱已存在於 Team Foundation 版本控制伺服器中，而且並非資料夾。
您已經在待簽入時，加入、分支或重新命名項目。
項目會在工作區內進行對應，但無法在本機磁碟上使用。
項目已隱匿。
您可以重新命名相同名稱的另一個檔案已在其中加入暫止簽入的項目，但您無法重新命名的已經分支但尚未簽入的項目。 當您重新命名含有暫止編輯的檔案時，將保留這些編輯。
在未先變更對應的情況下，無法重新命名明確對應的項目。 例如，如果工作資料夾 $/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
請參閱
工作
參考
Delete 命令 (Team Foundation 版本控制)