Rename コマンド (Team Foundation バージョン管理)
rename コマンドは、ファイルまたはフォルダーの名前またはパスを変更します。 ファイルまたはフォルダーを新しい場所に移動するには、rename コマンド、またはそのエイリアスである move や ren を使用できます。
注意
このコマンドの結果は、チェックイン操作を実行するまでは 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 オプションに値を指定します。 ユーザー名の値は、DOMAIN\UserName または UserName のいずれかとして指定できます。 |
オプション |
説明 |
|---|---|
/lock |
指定した項目を他のユーザーがチェックインまたはチェックアウトできないようにする場合は、このオプションを含めます。 このオプションを指定しない場合、項目に既存のロック状態は変更されません。 詳細については、「ロックの種類について」を参照してください。 ロック オプション:
|
/login |
Visual Studio Team Foundation Server でユーザーを認証するためのユーザー名とパスワードを指定します。 |
解説
tf コマンド ライン ユーティリティの rename コマンドを使用して、ワークスペースでバージョン管理された項目の移動または名前の変更ができます。 rename コマンドを使って複数のファイルを移動するには、ワイルドカード文字を指定します。 バージョン管理されている複数のファイルまたはフォルダーの名前を変更する機能は、コマンド ラインでのみ使用できます。
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 コマンド ライン ユーティリティのコマンド」を参照してください。
例
次の例は、1254.c という名前を 314.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 バージョン管理)