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

  • [アーティクル]

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

Visual Studio 2019 | Visual Studio 2022

delete コマンドは、Azure DevOps サーバーおよびディスクからファイルとフォルダーを削除します。

注意

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

前提条件

delete コマンドを使用するには、[チェックアウト] アクセス許可が [許可] に設定されている必要があります。 /lock オプションに none 以外の値を指定する場合、[ロック] アクセス許可が [許可] に設定されている必要があります。 また、ワークスペースを所有しているか、グローバルな [ワークスペースの管理] アクセス許可が [許可] に設定されている必要があります。 詳細については、「既定の TFVC アクセス許可」を参照してください。

構文

tf delete [/lock:(none|checkin|checkout)] [/recursive] [/login:username,[password]] itemspec

パラメーター

引数

Argument

説明

<itemspec>

Azure DevOps サーバーから削除するファイルまたはフォルダーを識別します。 TFVC でどのように itemspec が解析され、スコープ内にある項目が特定されるかの詳細については、「オプションを使用してコマンドの機能を変更する」を参照してください。

注意

複数の itemspec 引数を指定できます。

<username>

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

Options

オプション

説明

/lock

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

ロック オプション:

  • none
    既定値。 ロックは適用されません。 指定したファイルにロックを設定したとしても、このオプションによって削除されます。 他のユーザーによって設定されたロックは削除されません。

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

  • checkout
    チェックインを実行してロックを解除するまで、指定した項目のチェックインやチェックアウトを他のユーザーが実行できないようにします。 他のユーザーが、指定されたどの項目をロックしても、ロック操作は失敗します。

/recursive

指定したディレクトリから、itemspec と一致するすべてのファイルおよび/またはフォルダーとサブフォルダーを削除します。

  • tf delete <folder1>\<folder2> /recursive は、<folder1>\<folder2> に含まれるすべてのファイルとサブディレクトリ、および <folder1>\<folder2> 自体を削除します。
  • tf delete <folder1>\<folder2> <filespec> /recursive は、<folder1>\<folder2> およびそのサブディレクトリのそれぞれに含まれる、filespec と一致するすべてのファイルとサブディレクトリ、および filespec と一致する任意のディレクトリに含まれるすべてのファイルとサブディレクトリを削除します。

次を含むワークスペースの例を示します。

いくつかのファイルを含む Folder1\AVeryLongDirectoryName、および Folder1\Folder2\AVeryImportantFile.txt

tf delete Folder1 AVer* /recursive

は、Folder1\AVeryLongDirectoryName とそのすべてのファイルを削除し、ワイルドカード文字と一致したため、Folder1\Folder2\AVeryImportantFile.txt も削除します。

/login

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

解説

delete コマンドは、種類が delete の指定した項目の保留中の変更をワークスペースに記録します。 checkin コマンドを使用して、種類が delete の保留中の変更を Azure DevOps サーバーにコミットすると、TFVC は Azure DevOps サーバーから項目を削除しますが、完全な削除ではありません。 dir コマンドを使用して、Azure DevOps サーバーで削除済みの項目を見つけることができます。削除済み項目を復元する場合は、Undelete コマンドを使用します。

ワークスペース内の項目を削除したが、変更をチェックインしていない場合は、Undo コマンドを使用して、項目をワークスペースに復元し、保留中の変更の一覧から削除を取り消すことができます。

別の保留中の変更が存在する項目を削除することはできません。 たとえば、チェックアウトしたファイルを削除することはできません。 このような項目を削除するには、undo コマンドを使用して現在保留中の変更を元に戻す必要があります。

保留中の削除をチェックインすると、TFVC はそのファイルを Azure DevOps サーバーで削除済みとしてマークします。 その後、自分または他のユーザーが他のワークスペースからその項目の get を実行すると、それらのワークスペースから項目が削除されます。

itemspec がフォルダーを指定すると、TFVC は既定でそのファイルとサブフォルダー、およびそれらが含まれるフォルダーすべてを削除します。

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

例

次の例では、指定したローカル ワークスペース フォルダー内のディスク上の 314.cs を削除し、変更をチェックインすると、バージョン管理システムから 314.cs が非永続的に削除されます。

tf delete 314.cs