Azure DevOps Services |Azure DevOps Server 2022 |Azure DevOps Server 2020
Visual Studio 2019 |Visual Studio 2022
Team Foundation Version Control (TFVC) undelete コマンドは、以前に削除された項目を復元します。
手記
このコマンドの結果は、チェックイン操作を実行するまで、他のワークスペースには表示されません。 詳細については、「コードの開発と保留中の変更の管理」を参照してください。
前提 条件
| カテゴリ | Requirements |
|---|---|
| アクセス許可 |
-
[許可] に設定されているアクセス許可を確認します。 - /lock オプションを None: Lock permission set to Allow 以外の値に含める場合。- ワークスペースの所有者または [ワークスペースの管理 ] アクセス許可が [許可] に設定されている。 |
詳細については、「既定の TFVC アクセス許可 」を参照してください。
構文
tf undelete [/noget] [/lock:(none|checkin|checkout)]
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]
パラメーター
以降のセクションでは、undelete コマンドの引数とオプションについて説明します。
引数
| 引数 | 形容 |
|---|---|
<item-specification> |
復元するファイルまたはフォルダーを識別します。 TFVC が <item-specification> 値を解析してスコープ内にある項目を決定する方法の詳細については、「Team Foundation バージョン管理コマンド使用する」を参照してください。 |
<deletion-ID> |
同じ名前を持つ複数の削除済みアイテムを明確に区別する一意識別子を指定します。 |
<username> |
/login オプションに値を提供します。 この値は、DOMAIN\<username> または <username>として指定できます。 |
オプション
オプションの
説明
/noget
削除されたアイテムをワークスペースに復元します。 チェックイン操作の完了が保留中の場合、このオプションはサーバー上の項目を復元しますが、項目の物理的なコピーをディスクにすぐに取得することはありません。
/lock
指定したファイルを他のユーザーがチェックインまたはチェックアウトできないようにします。 詳細については、「ロックの種類を理解する」を参照してください。
ロック オプション:
-
None: このオプションが既定値です。 ロックは適用されません。 -
Checkin: 他のユーザーは指定されたアイテムをチェックアウトできますが、ロックされたファイルをチェックインしてロックを解除するまで、ロックされたファイルのリビジョンをチェックインすることはできません。 他のユーザーが指定した項目のいずれかをロックした場合、ロック操作は失敗します。 -
Checkout: ロックされたファイルをチェックインしてロックを解除するまで、他のユーザーが指定した項目をチェックインまたはチェックアウトできないようにします。 他のユーザーが指定した項目のいずれかをロックした場合、ロック操作は失敗します。
/recursive
指定したディレクトリからすべてのファイルとサブフォルダーを復元します。
/login
Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。
備考
undelete コマンド ライン機能の tf コマンドは、チェックイン操作の完了を保留して、指定されたファイルまたはフォルダーを復元対象としてスケジュールします。 また、/noget オプションを明示的に含めない限り、指定した項目をサーバーからローカル ディスクに取得します。
同じ名前のファイルまたはフォルダーが同じサーバー フォルダーから削除された場合は、復元する削除済みアイテムを示すために、<deletion-ID> パラメーターの値を含める必要があります。
<deletion-ID> コマンドを使用して、dir を取得できます。
復元後にファイルを変更する場合は、通常どおり 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