プロジェクトを削除する

Azure DevOps Services |Azure DevOps Server 2022 および Azure DevOps Server 2019

プロジェクトが不要になった場合は、Azure DevOps で組織またはコレクションから削除できます。 オンプレミスの Azure DevOps Server から Azure DevOps Services に移行する場合は、プロジェクトの削除も必要になる場合があります。 未使用のプロジェクトを削除すると、現在使用されているプロジェクトのみに制限することで、ナビゲーションを強化できます。

前提条件

プロジェクト データの保存

ソース コード、ビルド データ、作業項目など、ユーザーが最も関心を持つデータを保存するには、次の手順に従います。 この手順は省略可能であり、プロジェクトを削除する前に考慮する必要があります。

• ソース コードとカスタム ビルド テンプレート:zip ファイルとしてファイルをダウンロードします。 リポジトリ、ファイル、またはフォルダーの を選択し、[Zip としてダウンロード] を選択します。 または、[ダウンロード] を選択して、現在選択されているフォルダー内のすべてのファイル、または現在選択されているファイルをダウンロードします。

  

  このプロセスでは、変更履歴や他の成果物へのリンクは保存されません。 Git を使用する場合、リポジトリをクローンして、完全なプロジェクト履歴とすべてのブランチを保持します。

• ビルド データ: ドロップ ビルド フォルダーにログとデータを保存するには、「ビルド結果の表示」を参照してください。

• 作業項目追跡データ: 作業項目クエリを作成し、Excel を使用して開きます。 Excel スプレッドシートを保存します。

  このプロセスでは、添付ファイル、変更履歴、または他の成果物へのリンクは保存されません。

詳細については、「データ保護の概要」を参照してください。

az devops project delete --id
                         [--org]
                         [--yes] 

az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes

削除済みプロジェクトの復元

Azure DevOps でプロジェクトを誤って削除してしまった場合、削除後 28 日以内であれば復元できます。

REST API を使用してプロジェクトを復元する

1. ブラウザー ウィンドウを開き、次の形式を使用する URL を入力します。

   http://ServerName:8080/tfs/DefaultCollection/ProjectName

   たとえば、FabrikamPrime という名前のサーバーに接続するには、「http://FabrikamPrime:8080/tfs/」と入力します。

   既定のポートは 8080 です。 既定値が使用されていない場合は、サーバーのポート番号とディレクトリを指定します。

2. 次の要求を使用して、削除されたプロジェクトの一覧を取得します。

   GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3
   

3. 次の要求を使用して、削除されたプロジェクトを復元します。

   PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
   api-version=5.0-preview.3
   

   要求本文

   {
    "state" : "wellFormed"
   }
   

PowerShell を使用してプロジェクトを復元する

1. 次の PowerShell スクリプトを実行して、削除されたプロジェクトの一覧を取得し、必ず $collectionUrl を更新してください。

   $collectionUrl = "https://localhost/defaultcollection"
   (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
   

2. プロジェクトを復元するには、次のスクリプトを使用します。 $collectionUrl と $projectName を必ず更新してください。

   $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 日間待機します。

関連コンテンツ

• プロジェクトを作成します
• プロジェクトの復元
• REST API を使用してプロジェクトを削除する
• TFSDeleteProject コマンド ライン ツールの使用