プロジェクトを削除する

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

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

注意事項

• Web ポータルから論理的に削除されたプロジェクトは、28 日以内に復元を行わない場合は完全に削除されます。
• まれに、バックエンドの再試行と複数のソースからデータを削除する必要があるため、削除プロセスに最大 70 日かかる場合があります。
• オンプレミスの Azure DevOps 管理コンソールからハード削除されたプロジェクトは復元できません。 詳細については、「プロジェクトの保存プロジェクト データの保存を参照してください。

前提条件

• アクセス許可:
  • プロジェクト コレクション管理者グループのメンバーになる。 組織の所有者は、自動的にこのグループのメンバーになります。
  • チーム プロジェクトの削除のアクセス許可を許可に設定します。 詳細については、「プロジェクト レベルのアクセス許可を表示する」を参照してください。
• 省略可能: プロジェクト データを保存 復元せずにプロジェクト データにアクセスする場合は、プロジェクトを削除する前に保存します。

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

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

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

  

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

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

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

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

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

プロジェクトを削除する

Browser

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

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

2. [設定の編集] を選択します。

   

3. プロジェクトを選択し、削除する 1 つ以上のプロジェクトをオンにして、Delete を選択します。

   

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

   

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

管理コンソール

管理コンソールは、オンプレミスの Azure DevOps サーバーでのみサポートされています。

Azure DevOps CLI

チーム プロジェクトは、 az devops プロジェクトの delete コマンドを使用して削除できます。 開始するには、「Azure DevOps CLI の概要」を参照してください。

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

パラメーター

• id: 必須。 削除するプロジェクトの ID。 プロジェクトの ID を確認するには、 az devops プロジェクト リスト コマンドを使用します。
• org: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として設定されていない場合、または git config を使用して取得された場合は必須です。 例: --org https://dev.azure.com/MyOrganizationName/.
• はい: 確認を求めないでください。

例

次のコマンドは、確認を求めることなく、指定した ID のチーム プロジェクトを削除します。

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

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

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

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

2. [設定の編集] を選択します。

   

3. Overview を選択し、下にスクロールして "最近削除されたプロジェクト" に移動します。

   

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

   

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
   

   次のスクリーンショットのような内容が表示されます。

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