次の方法で共有

[名前の変更] コマンド (Team Foundation バージョン コントロール)

  • [アーティクル]

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

Visual Studio 2019 |Visual Studio 2022

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

手記

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

前提 条件

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

構文

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

パラメーター

引数

引数の

説明

<olditem>

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

<newitem>

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

<username>

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

オプション

オプションの

説明

/lock

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

ロック オプション:

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

/login

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

備考

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

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

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

存在しないフォルダーを指定する 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