Azure DevOps Serviços | Azure DevOps Server | Azure DevOps Server 2022
Se um projeto se tornar obsoleto, pode eliminá-lo da sua organização ou coleção na Azure DevOps. Se estiver a migrar de um Azure DevOps Server on-premises para Azure DevOps Services, pode também precisar de eliminar o projeto. A remoção de projetos não utilizados pode melhorar a navegação, limitando-a apenas aos projetos que estão atualmente em uso.
Atenção
- Os projetos arquivados temporariamente no portal web são removidos permanentemente se não forem restaurados no prazo de 28 dias.
- Em casos raros, o nosso processo de eliminação pode demorar até 70 dias devido a repetições do back-end e à necessidade de eliminar dados de várias fontes.
- Projetos apagados diretamente da Consola de Administração Azure DevOps local não podem ser restaurados.
Para obter mais informações, consulte Restaurar um projeto e Salvar dados do projeto.
Pré-requisitos
| Categoria |
Requerimentos |
| Permissões |
Apagar a permissão do projeto da equipa definida para Permitir. Para obter mais informações, consulte 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 que mais interessam aos usuários, como código-fonte, dados de compilação e itens de trabalho. Este procedimento é opcional e algo que você pode considerar antes de excluir um projeto.
Código-fonte e modelos personalizados: Descarregue os seus ficheiros como ficheiro zip.
para o repositório, ficheiro ou pasta e selecione Baixar como Zip. Ou, selecione 
Download para descarregar todos os ficheiros na pasta selecionada ou o ficheiro selecionado.
Esse processo não salva nenhum histórico de alterações ou links para outros artefatos. Se você usa o Git, clone seus repositórios para manter o histórico completo do projeto e todas as ramificações.
Dados da compilação: Para guardar logs e dados nas suas pastas de compilação, veja Ver resultados da compilação.
**Dados de rastreio de itens de trabalho: Crie uma consulta ao item de trabalho e abra-a usando Excel. Salve a planilha do Excel.
Esse processo não salva anexos, altera o histórico ou vincula a outros artefatos.
Para obter mais informações, consulte nossa Visão geral da proteção de dados.
Excluir projeto
Use seu navegador da Web para executar uma exclusão suave. Após 28 dias, os projetos são excluídos permanentemente se não forem restaurados dentro desse prazo.
Inicie sessão na sua organização (https://dev.azure.com/{yourorganization}).
Selecione 
Definições de organização.
Selecione Projetos, marque um ou mais projetos para eliminar e depois selecione Eliminar.
Confirme a eliminação introduzindo o nome do projeto e depois selecione Apagar no ecrã pop-up.
Seu projeto é excluído e pode ser restaurado até 28 dias depois. O projeto excluído é removido da lista de projetos.
A Consola de Administração é apenas suportada para servidores Azure DevOps on-premises.
Use a Consola de Administração Azure DevOps para realizar uma eliminação completa. Os projetos são excluídos permanentemente e não estão sujeitos a restauração.
Usando o console de administração, você pode excluir um projeto de uma coleção de projetos. Depois, precisa de apagar manualmente quaisquer relatórios associados e o portal do projeto SharePoint. Ou então, 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 Administradores do Team Foundation (obrigatório).
- Grupo de Administradores de Sistema SQL Server (obrigatório).
- Grupo de Administradores Agrícolas para Produtos SharePoint (obrigatório quando a sua implementação utiliza Produtos SharePoint).
Abra o console de administração e exclua o projeto de sua coleção de projetos.
Escolha se deseja excluir dados externos associados ao projeto e, em seguida, inicie a ação de exclusão.
(Opcional) Para rever o estado da ação de eliminar, abra o separador Estado.
Para rever os detalhes da ação de eliminação, pode abrir o ficheiro de registo tanto no separador Estado como no separador de Registos.
Você pode excluir um projeto de equipe com o comando az devops project delete . Para começar, veja Comece com Azure DevOps CLI.
az devops project delete --id
[--org]
[--yes]
Parâmetros
- id: Obrigatório. A ID do projeto que você deseja excluir. Para determinar a 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 predefinido ou coletado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.
- sim: Não solicitar confirmação.
Exemplo
O comando a seguir exclui o projeto de equipe com a ID especificada sem solicitar a confirmação.
az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes
Os comandos CLI do Azure DevOps não são suportados para Azure DevOps Server.
Excluir relatórios que permanecem após a exclusão de um projeto
Se o seu projeto usou relatórios do SQL Server e não apagou artefactos externos, pode apagar os relatórios usando o SQL Server Report Manager. Na página de coleção de projetos, exclua a pasta que corresponde ao projeto excluído.
Restaurar um projeto excluído
Se apagar inadvertidamente um projeto no Azure DevOps, pode restaurá-lo dentro de 28 dias após a sua eliminação.
Inicie sessão na sua organização (https://dev.azure.com/{Your_Organization}).
Selecione Definições de organização.
Selecione Visão Geral e depois desça até "projetos recentemente eliminados".
Selecione o projeto que quer restaurar e depois selecione Restaurar.
Entre na sua instância (http://{ServerName:8080/tfs/}/{CollectionName}).
Escolher Definições de administrador.
Selecione Projetos e depois desça até Projetos eliminados recentemente.
Selecione o projeto que quer restaurar e depois selecione Restaurar.
Restaurar projeto com a API REST
Aviso
Para restaurar um projeto com um nome existente, renomeie o projeto primeiro. Para renomear o projeto, digite o seguinte texto no corpo da solicitação: "name":"new name".
Abra uma janela do navegador e insira um URL que use o seguinte formulário:
http://ServerName:8080/tfs/DefaultCollection/ProjectName
Por exemplo, para se ligar ao servidor chamado FabrikamPrime, introduza: 'http://FabrikamPrime:8080/tfs/'.
A porta padrão é 8080. Especifique o número da porta e o diretório do seu servidor caso os valores padrão não sejam utilizados.
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 do pedido
{
"state" : "wellFormed"
}
Restaurar projeto com o PowerShell
Execute o seguinte script do PowerShell para obter uma lista de projetos apagados 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.
FAQs
Veja as seguintes perguntas frequentes sobre a eliminação de projetos no 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. Uma vez que o projeto é excluído permanentemente, os links de item de trabalho são automaticamente limpos dentro de 24 horas. Se você precisar que os links de item de trabalho sejam limpos mais rapidamente do que isso, poderá removê-los manualmente do formulário de item de trabalho diretamente.
P: Apaguei um projeto no Azure DevOps, mas no Visual Studio Team Explorer ainda lá está, o que faço?
R: Aguarde 28 dias antes que o projeto seja excluído permanentemente.
Use IA para gerir a eliminação e restauração de projetos
Se usar GitHub Copilot, o Azure DevOps MCP Server pode ajudá-lo a apagar, restaurar e limpar projetos Azure DevOps de forma segura através de prompts em linguagem natural.
Exemplos de mensagens para eliminação e restauro de projetos
| Tarefa |
Exemplo de prompt |
| Planeie uma eliminaçã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 apagado 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 |
| Limpeza 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 |
| Auditoria de projetos para identificar candidatos à eliminaçã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 eliminação de projetos via 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 |
| Resolução de problemas em links de itens de trabalho danificados |
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 |
Sugestão
Para melhores resultados, use estes prompts em modo agente com o Azure DevOps MCP Server ligado. Personalize os prompts com o nome específico do seu projeto, organização ou cenário de migração.
Conteúdo relacionado
