次の方法で共有


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

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

Visual Studio 2019 |Visual Studio 2022

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

手記

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

前提 条件

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

構文

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

パラメーター

引数

引数の

説明

<itemspec>

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

手記

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

<username>

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

オプション

オプションの

説明

/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 と、フォルダー 1\Folder2\AVeryImportantFile.txt

tf delete Folder1 AVer* /recursive

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

/login

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

備考

delete コマンドは、指定した項目について、ワークスペース内の delete タイプの保留中の変更を記録します。 checkin コマンドを使用して Azure DevOps サーバーに delete の種類の保留中の変更をコミットすると、TFVC は Azure DevOps サーバーから項目を削除しますが、完全には削除しません。 削除済みアイテムは、dir コマンドを使用して Azure DevOps サーバーで検索できます。削除済みアイテムは、Undelete コマンドを使用して復元できます。

ワークスペース内のアイテムを削除しても、変更をチェックインしていない場合は、元に戻すコマンドを使用して、アイテムをワークスペースに復元し、保留中の変更の一覧から削除を削除できます。

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

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

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

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

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

tf delete 314.cs