Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022
プロジェクトが古くなった場合は、Azure DevOpsの組織またはコレクションから削除できます。 オンプレミスのAzure DevOps Serverから Azure DevOps Services に移行する場合は、プロジェクトの削除が必要になる場合もあります。 未使用のプロジェクトを削除すると、現在使用されているプロジェクトのみに制限することで、ナビゲーションを強化できます。
注意事項
- Web ポータルから論理的に削除されたプロジェクトは、28 日以内に復元を行わない場合は完全に削除されます。
- まれに、バックエンドの再試行と複数のソースからデータを削除する必要があるため、削除プロセスに最大 70 日かかる場合があります。
- オンプレミスのAzure DevOps管理コンソールからハード削除されたプロジェクトは復元できません。
詳細については、「プロジェクトの復元」および「プロジェクト データの保存」を参照してください。
前提条件
| カテゴリ |
要件 |
| Permissions |
- プロジェクト コレクション管理者グループのメンバー。 組織の所有者は、自動的にこのグループのメンバーになります。
- [許可] に設定されたチーム プロジェクトのアクセス許可を削除します。 詳細については、「プロジェクト レベルのアクセス許可を表示する」を参照してください。 |
| オプション |
復元せずにプロジェクト データにアクセスする場合は、プロジェクトを削除する前にプロジェクト データ を保存します。 |
| カテゴリ |
要件 |
| Permissions |
[許可] に設定されたチーム プロジェクトのアクセス許可を削除します。 詳細については、「アクセス許可の表示」を参照してください。 |
| オプション |
プロジェクトデータを削除すると元に戻せないデータ損失が生じるので、プロジェクトデータを保存します。 |
プロジェクト データの保存
ソース コード、ビルド データ、作業項目など、ユーザーが最も関心を持つデータを保存するには、次の手順に従います。 この手順は省略可能であり、プロジェクトを削除する前に考慮する必要があります。
ソース コードとカスタム ビルド テンプレート: ファイルを zip ファイルとしてダウンロードします。 リポジトリ、ファイル、またはフォルダーのリポジトリ アクションを選択し、[Zip としてダウンロード] を選択します。 または、[ ダウンロード] を選択して、現在選択されているフォルダー内のすべてのファイル、または現在選択されているファイルをダウンロードします。
このプロセスでは、変更履歴や他の成果物へのリンクは保存されません。 Git を使用する場合、リポジトリをクローンして、完全なプロジェクト履歴とすべてのブランチを保持します。
ビルド データ: ドロップ ビルド フォルダーにログとデータを保存するには、「 ビルド結果の表示」を参照してください。
**作業項目追跡データ: 作業項目クエリを作成し、 Excel を使用して開きます。 Excel スプレッドシートを保存します。
このプロセスでは、添付ファイル、変更履歴、または他の成果物へのリンクは保存されません。
詳細については、「データ保護の概要」を参照してください。
プロジェクトの削除
Web ブラウザーを使用して論理的な削除を実行します。 28 日後、その期間内に復元されない場合、プロジェクトは完全に削除されます。
組織にサインインします ()。
歯車アイコンをクリックして「組織の設定」を選択します。
選択、[組織の設定] のスクリーンショット。
[プロジェクト] を選択し、削除する 1 つ以上のプロジェクトをオンにして、[削除] を選択します。
選択したプロジェクトのシーケンス、各プロジェクトの確認、削除のスクリーンショット。
プロジェクト名を入力して削除を確認し、ポップアップ画面で [削除] を選択します。
ポップアップ確認のプロジェクト削除画面のスクリーンショット。
プロジェクトは削除され、その後最大 28 日まで復元できます。 削除したプロジェクトは、プロジェクト リストから削除されます。
管理コンソールは、オンプレミスのAzure DevOps サーバーでのみサポートされます。
Azure DevOps管理コンソールを使用して、ハード削除を実行します。 プロジェクトは完全に削除され、復元の対象外となります。
管理コンソールを使用すると、プロジェクト コレクションからプロジェクトを削除できます。 その後、関連するレポートとSharePointプロジェクトポータルを手動で削除する必要があります。 または、TFSDeleteProject コマンド ライン ツール を使用して、すべての成果物を削除できます。
次の管理者グループの 1 つ以上のメンバーでない場合は、今すぐアクセス許可を取得します。
- Team Foundation 管理者グループ (必須)。
- SQL Server システム管理者グループ (必須)。
- SharePoint 製品のファーム管理者グループ (展開で SharePoint 製品を使用する場合に必要)。
管理コンソールを開き、そのプロジェクト コレクションからプロジェクトを削除します。
管理コンソールの [プロジェクトの削除] のスクリーンショット。
プロジェクトに関連付けられている外部データを削除するかどうかを選択し、削除アクションを開始します。
[チーム プロジェクトの削除] ダイアログのスクリーンショット。
(省略可能)削除アクションの状態を確認するには、[状態] タブを開きます。
削除アクションの詳細を確認するには、[状態] タブまたは [ログ] タブからログ ファイルを開きます。
チーム プロジェクトは、az devops project delete コマンドを使用して削除できます。 開始するには、「GET started with Azure DevOps CLIを参照してください。
az devops project delete --id
[--org]
[--yes]
パラメーター
- id: 必須。 削除するプロジェクトの ID。 プロジェクトの ID を確認するには、az devops project list コマンドを使用します。
- org: Azure DevOps組織の URL。 を使用して、既定の組織を構成できます。 既定として設定されていない場合、または を使用して取得された場合は必須です。 例: .
- はい: 確認を求めないでください。
例
次のコマンドは、確認を求めることなく、指定した ID のチーム プロジェクトを削除します。
az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes
Azure DevOps CLI コマンドは、Azure DevOps Serverではサポートされていません。
プロジェクトを削除した後も残っているレポートを削除する
プロジェクトSQL Serverレポートを使用していて、外部成果物を削除しなかった場合は、レポート マネージャー SQL Server使用してレポートを削除できます。 プロジェクト コレクション ページから、削除されたプロジェクトに対応するフォルダーを削除します。
delete コマンドを使用したコンテキスト メニューのスクリーンショット。
削除済みプロジェクトの復元
Azure DevOpsで誤ってプロジェクトを削除した場合は、削除から 28 日以内に復元できます。
組織にサインインします ()。
歯車アイコンをクリックし、組織設定を選択します。
歯車アイコン、[組織の設定] を示すスクリーンショット。
[概要] を選択し、[最近削除されたプロジェクト] まで下にスクロールします。
最近削除されたプロジェクトを示すスクリーンショット。
復元するプロジェクトを強調表示し、[復元] を選択します。
強調表示されたプロジェクトと [復元] ボタンを示すスクリーンショット。
インスタンスにサインインします ()。
歯車アイコンの [管理設定] を選択します。
赤いボックスで囲まれた [管理者の設定] ボタンを示すスクリーンショット。
[プロジェクト] を選択し、[最近削除されたプロジェクト] まで下にスクロールします。
復元するプロジェクトを強調表示し、[復元] を選択します。
![プロジェクトを強調表示する方法を示すスクリーンショット。[Azure DevOps Serverの復元] を選択します。](media/restore-project/recently-deleted-projects.png?view=azure-devops)
REST API を使用してプロジェクトを復元する
警告
既存の名前でプロジェクトを復元するには、最初にプロジェクトの名前を変更します。 プロジェクトの名前を変更するには、要求本文に次のテキストを入力します: 。
ブラウザー ウィンドウを開き、次の形式を使用する URL を入力します。
''
たとえば、FabrikamPrime という名前のサーバーに接続するには、「」と入力します。
既定のポートは 8080 です。 既定値が使用されていない場合は、サーバーのポート番号とディレクトリを指定します。
次の要求を使用して、削除されたプロジェクトの一覧を取得します。
GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3
次の要求を使用して、削除されたプロジェクトを復元します。
PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
api-version=5.0-preview.3
要求本文
{
"state" : "wellFormed"
}
PowerShell を使用してプロジェクトを復元する
次の PowerShell スクリプトを実行して、削除されたプロジェクトの一覧を取得し、必ず を更新してください。
$collectionUrl = "https://localhost/defaultcollection"
(irm -Uri "$collectionUrl/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
プロジェクトを復元するには、次のスクリプトを使用します。 と を必ず更新してください。
$collectionUrl = "https://localhost/defaultcollection"
$projectName = 'Project1'
$project = (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
| where {$_.name -eq $projectName}
irm -Uri ($project.url + "?api-version=5.0-preview.3")
-UseDefaultCredentials -Method PATCH -Body '{"state":"wellFormed"}'
-ContentType 'application/json'
プロジェクトと関連するデータが復元されます。
よく寄せられる質問
Azure DevOpsでのプロジェクトの削除に関してよく寄せられる次の質問を参照してください。
Q: 1 つのプロジェクトを削除した後も、残りのプロジェクトの作業項目に削除されたプロジェクト作業項目へのリンクが残っているのはなぜですか?
A: 削除されたプロジェクト作業項目を指す作業項目リンクは、プロジェクトが完全に削除されるまで残ります。 プロジェクトが完全に削除されると、作業項目のリンクは 24 時間以内に自動的にクリーンアップされます。 作業項目リンクをそれより早くクリーンアップする必要がある場合は、作業項目フォームから直接手動で削除できます。
Q: Azure DevOpsでプロジェクトを削除しましたが、チーム エクスプローラー Visual Studioまだそこにありますが、どうすればよいですか?
A: プロジェクトが完全に削除されるまで 28 日間待機します。
AI を使用してプロジェクトの削除と復元を管理する
GitHub Copilotを使用する場合、Azure DevOps MCP Server は、自然言語プロンプトを使用してAzure DevOps プロジェクトを安全に削除、復元、クリーンアップするのに役立ちます。
プロジェクトの削除と復元のプロンプトの例
| Task |
プロンプトの例 |
| 安全なプロジェクトの削除を計画する |
I need to delete an obsolete project but want to preserve its build definitions and work item history first. Walk me through exporting the critical data before I delete the project |
| 誤って削除されたプロジェクトを復元する |
A team member accidentally deleted our staging project yesterday. Show me how to restore it before the 28-day permanent deletion window expires and verify all repos and pipelines are intact |
| 移行後のクリーンアップ |
We migrated from Azure DevOps Server to Azure DevOps Services and have leftover projects in the old collection. Guide me through identifying which ones are safe to hard-delete from the admin console |
| 削除候補の監査プロジェクト |
List all projects in my organization that have had zero commits, no pipeline runs, and no work item updates in the last 6 months so I can evaluate them for deletion |
| CLI を使用してプロジェクトの削除を自動化する |
I need to delete 5 test projects we created during a proof of concept. Show me how to use the Azure DevOps CLI to delete them in batch and verify each deletion completed |
| 壊れた作業項目リンクのトラブルシューティング |
After deleting a project, work items in our other projects still show links to the deleted project. Explain when these links get cleaned up and how to remove them manually if needed |
ヒント
最適な結果を得るには、Azure DevOps MCP サーバーが接続されているエージェント モードでこれらのプロンプトを使用します。 特定のプロジェクト名、組織、または移行シナリオでプロンプトをカスタマイズします。
関連コンテンツ
- プロジェクトを作成します
- プロジェクトの復元
- REST API を使用してプロジェクトを削除する
- TFSDeleteProject コマンド ライン ツールの使用