プロジェクトを削除する

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

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

前提条件

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

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

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

  

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

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

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

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

詳細については、 Data Protection の概要を参照してください。

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 コマンド ライン ツールを使用する