Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Se um projeto se tornar obsoleto, você poderá excluí-lo de sua organização ou coleção no Azure DevOps. Se você estiver migrando de um Azure DevOps Server local para Azure DevOps Services, talvez também seja necessário excluir o projeto. A remoção de projetos não utilizados pode aprimorar a navegação limitando-a apenas aos projetos que estão em uso no momento.
Atenção
- Os projetos excluídos temporariamente do portal da Web são removidos permanentemente se não forem restaurados em até 28 dias.
- Em casos raros, nosso processo de exclusão pode levar até 70 dias devido a novas tentativas de back-end e à necessidade de excluir dados de várias origens.
- Não é possível restaurar projetos excluídos do Console de Administração Azure DevOps local.
Para obter mais informações, consulte Restaurar um projeto e Salvar dados do projeto.
Pré-requisitos
| Categoria |
Requisitos |
| Permissões |
- Membro do grupo de Administradores da Coleção de Projetos . Os proprietários da organização são automaticamente membros desse grupo.
– Excluir a permissão do projeto de equipe definida como Permitir. Para obter mais informações, confira Ver permissões no nível do projeto. |
| Opcional |
Salvar dados do projeto antes de excluir um projeto se você quiser acessar os dados do projeto sem restaurá-los. |
| Categoria |
Requisitos |
| Permissões |
Excluir a permissão de projeto de equipe definida como Permitir. Para obter mais informações, confira Exibir permissões. |
| Opcional |
Salve os dados do projeto, pois excluir um projeto resulta em perda irreversível de dados. |
Salvar dados do projeto
Use os procedimentos a seguir para salvar os dados com os quais os usuários mais se importam, como código-fonte, dados de build e itens de trabalho. Esse procedimento é opcional e algo que você pode considerar antes de excluir um projeto.
Código-fonte e modelos de build personalizados: baixe seus arquivos como um arquivo zip. Selecione 
para o repositório, arquivo ou pasta e selecione Baixar como Zip. Ou selecione 
Baixar para baixar todos os arquivos na pasta selecionada no momento ou no arquivo selecionado no momento.
Esse processo não salva nenhum histórico de alterações nem links para outros artefatos. Se você usar o Git, clone seus repositórios para manter o histórico completo do projeto e todas as ramificações.
Dados de compilação: para salvar logs e dados em suas pastas de build, consulte Exibir os resultados do build.
**Dados de acompanhamento de item de trabalho: crie uma consulta de item de trabalho e abra-a usando o Excel. Salve a planilha do Excel.
Esse processo não salva nenhum anexo, histórico de alterações nem links para outros artefatos.
Para obter mais informações, consulte nossa Visão geral de proteção de dados.
Excluir projeto
Use seu navegador da Web para executar uma exclusão reversível. Após 28 dias, os projetos serão excluídos permanentemente se não forem restaurados dentro desse período.
Entre em sua organização (https://dev.azure.com/{yourorganization}).
Selecione 
Configurações da organização.
Selecione Projetos, marque um ou mais projetos a serem excluídos e selecione Excluir.
Confirme a exclusão inserindo o nome do projeto e selecione Excluir na tela pop-up.
Seu projeto é excluído e pode ser restaurado até 28 dias depois. Seu projeto excluído é removido da sua lista de projetos.
O Console de Administração só tem suporte para servidores Azure DevOps locais.
Use o Console de Administração do Azure DevOps para executar uma exclusão dura. Os projetos são excluídos permanentemente e não estão sujeitos à restauração.
Usando o console de administração, você pode excluir um projeto de uma coleção de projetos. Posteriormente, você precisa excluir manualmente todos os relatórios associados e SharePoint portal do projeto. Ou você pode usar a ferramenta de linha de comando TFSDeleteProject para excluir todos os artefatos.
Se você não for membro de um ou mais dos seguintes grupos de administradores, obtenha permissões agora:
- Grupo de Administradores da Team Foundation (obrigatório).
- Grupo de administradores do sistema do SQL Server (obrigatório).
- Grupo Administradores de Farm para Produtos SharePoint (necessário quando sua implantação usa Produtos SharePoint).
Abra o console de administração e exclua o projeto da sua coleção de projetos.
Escolha se deseja excluir dados externos associados ao projeto e inicie a ação de exclusão.
(Opcional) Para examinar o status da ação de exclusão, abra a guia Status.
Para examinar os detalhes da ação de exclusão, você pode abrir o arquivo de log na guia Status ou na guia Logs.
Você pode excluir um projeto da equipe com o comando az devops project delete. Para começar, consulte Introdução ao Azure DevOps CLI.
az devops project delete --id
[--org]
[--yes]
Parâmetros
- id: Obrigatório. O ID do projeto que você deseja excluir. Para determinar o ID de um projeto, use o comando az devops project list.
- org: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando
az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.
- Sim: não solicite confirmação.
Exemplo
O comando a seguir exclui o projeto da equipe com o ID especificado sem solicitar a confirmação.
az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes
não há suporte para comandos da CLI Azure DevOps para Azure DevOps Server.
Excluir relatórios que permanecem após a exclusão de um projeto
Se o projeto usou SQL Server relatório e você não excluiu artefatos externos, você pode excluir os relatórios usando SQL Server Gerenciador de Relatórios. Na página de coleção de projetos, exclua a pasta que corresponde ao projeto excluído.
Restaurar um projeto excluído
Se você excluir inadvertidamente um projeto em Azure DevOps, poderá restaurá-lo dentro de 28 dias após sua exclusão.
Entre em sua organização (https://dev.azure.com/{Your_Organization}).
Selecione Configurações da organização.
Selecione Visão geral e role para baixo até "projetos excluídos recentemente".
Realce o projeto que você deseja restaurar e selecione Restaurar.
Entre na instância (http://{ServerName:8080/tfs/}/{CollectionName}).
Escolha as configurações de administrador do .
Selecione Projetos e role para baixo até projetos excluídos recentemente.
Realce o projeto que você deseja restaurar e selecione Restaurar.
Restaurar projeto com API REST
Aviso
Para restaurar um projeto com um nome existente, renomeie o projeto primeiro. Para renomear o projeto, insira o seguinte texto no corpo da solicitação: "name":"new name".
Abra uma janela do navegador e insira uma URL que use o seguinte formato:
http://ServerName:8080/tfs/DefaultCollection/ProjectName
Por exemplo, para se conectar ao servidor chamado FabrikamPrime, insira: 'http://FabrikamPrime:8080/tfs/'.
A porta padrão é a 8080. Especifique o número da porta e o diretório para o seu servidor, caso os padrões não sejam usados.
Obtenha uma lista de projetos excluídos usando a seguinte solicitação:
GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3
Restaure um projeto excluído usando a seguinte solicitação:
PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
api-version=5.0-preview.3
Corpo da solicitação
{
"state" : "wellFormed"
}
Restaurar projeto com o PowerShell
Execute o seguinte script do PowerShell para obter uma lista de projetos excluídos e certifique-se de atualizar $collectionUrl.
$collectionUrl = "https://localhost/defaultcollection"
(irm -Uri "$collectionUrl/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
Use o script a seguir para restaurar um projeto. Certifique-se de atualizar $collectionUrl e $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'
Seu projeto e os dados associados são restaurados.
Perguntas frequentes
Consulte as seguintes perguntas frequentes sobre a exclusão de projetos em Azure DevOps.
P: Depois de excluir um projeto, por que os itens de trabalho em um projeto restante ainda têm links para os itens de trabalho do projeto excluídos?
R: Os links de item de trabalho que apontam para itens de trabalho de projeto excluídos permanecerão até que o projeto seja excluído permanentemente. Depois que o projeto for excluído permanentemente, os links do item de trabalho serão limpos automaticamente dentro de 24 horas. Se você precisar que os links do item de trabalho sejam limpos mais rapidamente do que isso, você poderá removê-los manualmente do formulário do item de trabalho diretamente.
P: Eu exclui um projeto em Azure DevOps, mas no Visual Studio Team Explorer ele ainda está lá, o que eu faço?
R: Aguarde 28 dias para que o projeto seja excluído permanentemente.
Usar a IA para gerenciar a exclusão e a restauração do projeto
Se você usar GitHub Copilot, o servidor MCP Azure DevOps poderá ajudá-lo a excluir, restaurar e limpar projetos Azure DevOps com segurança por meio de prompts de linguagem natural.
Solicitações de exemplo para exclusão e restauração de projeto
| Tarefa |
Prompt de exemplo |
| Planejar uma exclusão segura do projeto |
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 |
| Restaurar um projeto excluído acidentalmente |
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 |
| Limpar após uma migração |
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 |
| Auditar projetos para candidatos à exclusão |
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 |
| Automatizar a exclusão do projeto por meio da 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 |
| Solucionar problemas de links rompidos em itens de trabalho |
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 |
Dica
Para obter os melhores resultados, use esses prompts no modo de agente com o servidor MCP Azure DevOps conectado. Personalize os prompts com seu nome de projeto específico, organização ou cenário de migração.
Conteúdo relacionado
