プロジェクトを削除する

  • [アーティクル]

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

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

注意事項

Web ポータルから削除されたプロジェクトは論理的に削除され、28 日以内に復元されない場合は完全に削除されます。 ただし、オンプレミスの Azure DevOps 管理istration Console から削除されたプロジェクトはハード削除され、復元できません。 復元の詳細については、「プロジェクトの復元」を参照してください。 復元せずに削除されたプロジェクトのデータにアクセスするには、 プロジェクト データを保存します。

前提条件

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

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

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

    Screenshot of Downloading code.

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

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

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

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

詳細については、データ保護の概要に関するページを参照してください。

プロジェクトを削除する

Web ブラウザーを使用して論理的な削除を実行します。 28 日後、その時間内に復元されない場合、プロジェクトは完全に削除されます。

  1. 組織にサインインします (https://dev.azure.com/{yourorganization})。

  2. gear icon[組織の設定] を選択します。

    Screenshot of selection, Organization settings.

  3. [プロジェクト] を選択し、削除する 1 つ以上のプロジェクトをチェックし、[削除] を選択します。

    Screenshot of sequence selected Projects, check each project, and delete.

  4. プロジェクト名を入力して削除を確認し、ポップアップ画面で [削除] を選択します。

    Screenshot of popup confirmation delete project screen.

プロジェクトは削除され、その後最大 28 日まで復元できます。 削除したプロジェクトは、プロジェクトの一覧から削除されます。

プロジェクトを削除した後にメインするレポートを削除する

プロジェクトで SQL Server レポートを使用していて、外部成果物を削除しなかった場合は、SQL Server レポート マネージャーを使用してレポートを削除できます。 プロジェクト コレクション ページから、削除されたプロジェクトに対応するフォルダーを削除します。

Screenshot of the context menu with delete command.

削除されたプロジェクトを復元する

Azure DevOps でプロジェクトを誤って削除した場合は、削除から 28 日以内に復元できます。

  1. 組織にサインインします (https://dev.azure.com/{yourorganization})。

  2. gear icon[組織の設定] を選択します。

    Screenshot showing the gear icon, Organization settings.

  3. [概要] を選択し、[最近削除されたプロジェクト] まで下にスクロールします。

    Screenshot that shows recently deleted projects.

  4. 復元するプロジェクトを強調表示し、[復元] を選択します。

    Screenshot showing highlighted project, and Restore button.

  1. インスタンスにサインインします (http://{ServerName:8080/tfs/}/{CollectionName})。

  2. 管理設定を選択gear iconします。

    Screenshot showing Admin settings button surrounded by red box.

  3. [プロジェクト] を選択し、[最近削除されたプロジェクト] まで下にスクロールします。

  4. 復元するプロジェクトを強調表示し、[復元] を選択します。

    Screenshot showing how to Highlight the project, and then select Restore for Azure DevOps Server.

Note

この UI では、Azure DevOps Server 2019 のチーム プロジェクトの復元はサポートされていません。 削除されたチーム プロジェクトを復元するには、次の REST API または PowerShell メソッドを使用します。 詳細については、「Projects-Update REST API」を参照してください。

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

警告

既に取得されている名前でプロジェクトを復元するには、復元する前にプロジェクトの名前を変更する必要があります。 プロジェクトの名前を変更するには、要求本文に次のテキストを入力します。 "name":"new name"

  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

    次のスクリーンショットのような内容が表示されます。 Screenshot of PowerShell script return example for deleted projects.

  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 でのプロジェクトの削除に関してよく寄せられる次の質問を参照してください。

A: 作業項目は、プロジェクトが削除されてから 24 時間以内に削除されます。

Q: Azure DevOps でプロジェクトを削除しましたが、Visual Studio Team エクスプローラーまだそこにありますが、どうすればよいですか。

A: プロジェクトが完全に削除されるまで 28 日間待機します。