バージョン管理されたファイルを破棄する
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
時間の経過と同時に、バージョン 管理サーバーは、増え続けるファイルとフォルダーを取得します。 これにより、ディスク領域の要件を管理しようとするときに問題が発生する可能性があります。 バージョン管理からすべてのプロジェクトとその階層を強制的に削除する必要がある場合があります。 たとえば、学習目的でのみプロジェクトが作成される場合や、一部のファイルがウイルスで汚染されている場合があります。 したがって、TFVC 管理者として、バージョン管理下にあるファイルやフォルダーを破棄しなければならない場合があります。
次の手順では、tf destroy
コマンドを使用してファイルとフォルダーを破棄する方法を示します。 ファイルは完全に削除されますが、関連付けられている履歴を保持できます。 tf destroy
で使用できるオプションと引数の詳細については、「Destroy コマンド (Team Foundation バージョン管理)を参照してください。
手記
destroy
操作は、コマンド ラインからのみ使用できます。
前提 条件
destroy
コマンドを使用するには、Team Foundation Administrators セキュリティ グループのメンバーになります。 詳細については、「既定の TFVC アクセス許可 」を参照してください。/keephistory
オプションを指定せずにtf destroy
を実行する前に、まず破棄するファイルを削除します。 詳細については、「バージョン 管理からファイルとフォルダーを削除する」を参照してください。 ファイルを削除すると、そのファイル名に削除 ID が含まれるようになりました。 たとえば、ファイル名が aFile.cs場合、削除後にファイル名は aFile.cs。x123。x123 は削除 ID です。ファイルを削除した後、TFVC ウェアハウスを同期できます。 そうしないと、倉庫は破棄されたアイテムと同期されません。
バージョン管理されたファイルを完全に破棄するには
Windows で、[スタート] を選択し、「開発者コマンド プロンプト」と入力します。 検索結果から、Visual Studio 2022の開発者コマンド プロンプト
ファイル aFile.cs を破棄せずに破棄をプレビューするには、コマンド プロンプトで次のように入力します。
tf destroy /preview /i $/MyTeamProject/aFile.cs
手記
コマンド プロンプト ウィンドウのテキストには
Destroyed: $/MyTeamProject/aFile.cs
が表示されますが、/preview
オプションを使用しても、ファイルは実際には破棄されません。ファイル aFile.csを破棄するには、コマンド プロンプトで次のように入力します。
tf destroy /i $/MyTeamProject/aFile.cs
このコマンドは、保留中の変更やシェルブセットに関する情報をコマンド プロンプト ウィンドウに表示します。
/i
または非対話型を指定した場合、ファイルが完全に削除される前に、[はい]、[なし]、または [すべての に対してはい] ダイアログが表示されません。aFolder 内のすべてのファイルを破棄し、同時にその履歴を保持するには、次のように入力します。
tf destroy /keephistory $/MyTeamProject/aFolder
手記
/keephistory
で/preview
を指定することはできません。このアクションでは、aFolder内のすべてのファイルに関する履歴情報が保持されます。
tf history
コマンドを使用して、ファイルの履歴を表示できます。 Visual Studio のソース管理エクスプローラーで履歴を表示することもできます。 詳細については、「履歴コマンドの」および「項目の履歴を取得する」を参照してください。 versionspec
値まで履歴情報を保持するには、/stopat
オプションを使用します。versionspec
値には、最新バージョン、特定の変更セット、または日付を指定できます。versionspec
値の詳細については、「Team Foundation バージョン管理コマンド使用する」を参照してください。プロジェクト MyTeamProject 内のすべてのファイルを破棄すると同時に、2005 年 10 月 23 日までのファイルの履歴を保持するには、次のように入力します。
tf destroy $/MyTeamProject /keephistory /stopat:D10/23/2005
/startcleanup
オプションを使用して、Azure DevOps Server によって参照されなくなったファイルの TFVC メタデータをすぐにクリーンアップします。 このオプションを指定しない場合、データベースが 5 日ごとに実行される SQL プロセスによって維持されると、それらのメタデータが削除されます。 TFVC メタデータの削除から 7 日後に、破棄されたファイルの内容は別の SQL プロセスによって削除されます。aFolder内のすべてのファイルを直ちに破棄するには、次のコマンドを入力します。
tf destroy /startcleanup $/MyTeamProject/aFolder