Rename コマンド (Team Foundation バージョン管理)

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Team Foundation バージョン管理 (TFVC) rename コマンドは、ファイルまたはフォルダーの名前またはパスを変更します。 rename コマンドまたはエイリアス move または ren を使用して、ファイルまたはフォルダーを新しい場所に移動できます。

注意

このコマンドの結果は、チェックを実行するまでサーバーに反映されません。 詳細については、「コードの開発と保留中の変更の管理」を参照してください。

前提条件

rename コマンドを使用するには、[チェックアウト] アクセス許可が [許可] に設定されている必要があります。 詳細については、「既定の TFVC アクセス許可」を参照してください。

構文

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

パラメーター

引数

Argument

説明

<olditem>

名前を変更するファイルまたはフォルダーの元の名前とパス。 C:\myfiles\314.cs などのローカル ワークスペース パス、または $/myfiles/314.cs などの TFVC サーバー パスを指定できます。

<newitem>

ファイルまたはフォルダーの新しい名前。 これを使用して、別のローカルまたは TFVC サーバー パスの場所を指定できます。

<username>

/login オプションに値を指定します。 ユーザー名の値は、DOMAIN\username または username として指定できます。

Options

オプション

説明

/lock

指定された項目を他のユーザーがチェックインまたはチェックアウトできないようにするには、このオプションを指定します。 このオプションを指定しない場合、項目の既存のロック状態は変わりません。 詳細については、「ロックの種類について」を参照してください。

ロック オプション:

  • None: ロックは適用されません。
  • Checkin: チェックインを実行してロックを解除するまで、他のユーザーは、指定された項目をチェックアウトできますが、ロックされたファイルのリビジョンをチェックインできません。 他のユーザーが、指定されたどの項目をロックしても、ロック操作は失敗します。
  • Checkout: チェックインを実行してロックを解除するまで、指定した項目のチェックインやチェックアウトを他のユーザーが実行できないようにします。 他のユーザーが、指定されたどの項目をロックしても、ロック操作は失敗します。

/login

Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。

解説

tf コマンド ライン ユーティリティの rename コマンドを使用して、ワークスペース内のバージョン管理された項目を移動または名前変更できます。 ワイルドカード文字を指定して複数のファイルを移動するには、rename コマンドを使用します。 複数のバージョン管理されたファイルまたはフォルダーの名前を変更する機能は、コマンド ラインからのみ使用できます。

rename コマンドを使用して、次のアクションを実行します。

  • olditem の名前を newitem に変更します (例: tf rename 314.cs 315.cs)。
  • パスが olditem のパスと異なる newitem を指定して、olditem を TFVC サーバー内の新しい場所に移動します (例: tf rename 314.cs ..\newdir\314.cs)。

存在しないフォルダーを指定する newitem を指定する場合、rename コマンドによって宛先フォルダーが作成されます。 newitem がフォルダーの場合、olditem は newitem の子になります。

次の場合、項目の名前を変更できません。

  • 同じワークスペースにチェックインされる前に既に削除している。
  • 新しい名前が TFVC サーバーに既に存在し、フォルダーではない。
  • 項目の保留中のチェックインを既に追加、分岐、または名前変更した。
  • 項目はワークスペースにマップされるが、ローカル ディスクで使用できない。
  • 項目がクロークされている。

同じ名前の別のファイルがチェックイン中に追加された項目の名前を変更することはできますが、分岐されたがまだチェックインされていない項目の名前を変更することはできません。 保留中の編集があるファイルの名前を変更すると、編集内容は保持されます。

明示的にマップされた項目の名前を変更するには、最初にマッピングを変更する必要があります。 たとえば、$/ProjectX/MyApp から c:\MyApp への作業フォルダー マッピングがある場合、MyApp の名前は変更できません。 MyApp の下にある項目の名前を変更できますが、MyApp 自体の名前は変更できません。

tf コマンド ライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。

例

次の例では、314.cs の名前を 1254.cs に変更します。

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

次の例では、314.cs の名前を 1254.cs に変更し、newdir フォルダーに移動します。

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

次の例では、Form1.vb の名前を MainPage.vb に変更し、ロックを適用します。

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