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

  • [アーティクル]

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

Visual Studio 2019 | Visual Studio 2022

Team Foundation バージョン管理 (TFVC) の undelete コマンドは、すでに削除された項目を復元します。

注意

チェックイン操作を実行するまで、このコマンドの結果は他のワークスペースには表示されません。 詳細については、「コードの開発と保留中の変更の管理」を参照してください。

前提条件

undelete コマンドを使用するには、次のようにします。

  • [チェックアウト] アクセス許可が [許可] に設定されている必要があります。
  • /lock オプションに None 以外の値を指定する場合、[ロック] アクセス許可が [許可] に設定されている必要があります。
  • ワークスペースを所有しているか、グローバルな [ワークスペースの管理] アクセス許可が [許可] に設定されている必要があります。

詳細については、「既定の TFVC アクセス許可」を参照してください。

構文

tf undelete [/noget] [/lock:(none|checkin|checkout)] 
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]

パラメーター

以降のセクションでは、undelete コマンドの引数とオプションについて説明します。

引数

Argument 説明
<item-specification> 復元するファイルまたはフォルダーを識別します。 TFVC が <item-specification> 値を解析してスコープ内の項目を判別する方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。
<deletion-ID> 同じ名前を持つ複数の削除済み項目を明確に区別する一意識別子を指定します。
<username> /login オプションに値を指定します。 この値は、DOMAIN\<username> または <username> として指定できます。

Options

オプション

説明

/noget

削除された項目をワークスペースに復元します。 チェックイン操作の完了待ちの間、このオプションはサーバー上の項目を復元しますが、項目の物理的なコピーをディスクにすぐに取り出すことはありません。

/lock

他のユーザーが、指定されたファイルをチェックインまたはチェックアウトできないようにします。 詳細については、「ロックの種類について」を参照してください。

ロック オプション:

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

/recursive

指定されたディレクトリからすべてのファイルとサブフォルダーを復元します。

/login

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

解説

tf コマンド ライン機能の undelete コマンドは、チェックイン操作の完了待ちの間、指定されたファイルまたはフォルダーの復元をスケジュールします。 また、/noget オプションを明示的に含める場合を除いて、指定された項目をサーバーからローカル ディスクに取り出します。

同じサーバー フォルダーから同じ名前のファイルまたはフォルダーが削除された場合は、<deletion-ID> パラメーターの値を含めて、復元する削除済み項目を指定する必要があります。 dir コマンドを使用して <deletion-ID> を取得できます。

復元後にファイルを変更する場合は、通常どおり checkout コマンドを使用して編集のためにファイルをチェックアウトします。

<item-specification> 値でフォルダーを指定すると、TFVC は既定でフォルダーのすべてのファイルとサブフォルダー、およびそれらに含まれるファイルを復元します。 フォルダー内のすべての項目を復元するわけではない場合は、最初にフォルダーとその項目の削除を取り消してから、保持しない項目を削除する必要があります。

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

例

次の例では、314.cs が削除されたサーバー フォルダーに 314.cs を復元します。 また、このコマンドでは、現在のワークスペースで最新バージョンの読み取り専用コピーを取り出します。

C:\projects>tf undelete c:\math\314.cs

次の例では、サーバー上で複数回削除されたすべての項目の削除 ID を表示します。

c:\projects>tf dir $/ /deleted

上記のコマンドからの出力は、次の例のようになります。

$/projects/math/314.cs;X10
$/projects/math/314.cs;X11

次の例では、X11 バージョンの 314.cs を、ファイルが削除されたサーバー フォルダーに復元します。 また、このコマンドでは、現在のワークスペースで最新バージョンの読み取り専用コピーを取り出します。

c:\projects>tf undelete 314.cs;X11