Servicios Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Si un proyecto deja de estar obsoleto, puede deletelo de su organización o colección en Azure DevOps. Si va a migrar de un Azure DevOps Server local a Azure DevOps Services, es posible que también tenga que eliminar el proyecto. La eliminación de proyectos sin usar puede mejorar la navegación limitando a solo los proyectos que están actualmente en uso.
Precaución
- Los proyectos eliminados temporalmente del portal web se quitan permanentemente si no se restauran en un plazo de 28 días.
- En raras ocasiones, el proceso de eliminación puede tardar hasta 70 días debido a reintentos de back-end y la necesidad de eliminar datos de varios orígenes.
- No se pueden restaurar los proyectos eliminados de forma permanente de la consola de administración de Azure DevOps local.
Para obtener más información, consulte Restauración de un proyecto y Guardado de datos del proyecto.
Requisitos previos
| Category |
Requisitos |
| Permisos |
Elimine el conjunto de permisos del proyecto de equipo en Permitir. Para obtener más información, consulte Vista de permisos. |
| Opcional |
Guardar datos del proyecto, ya que la eliminación de un proyecto da como resultado una pérdida de datos irreversible. |
Guardar datos del proyecto
Use los procedimientos siguientes para guardar los datos que más le interesan a los usuarios, como el código fuente, los datos de compilación y los elementos de trabajo. Este procedimiento es opcional y algo que puede considerar antes de eliminar un proyecto.
Código fuente y plantillas de compilación personalizadas: descargue los archivos como un archivo ZIP. Seleccione 
repositorio para el repositorio, el archivo o la carpeta y seleccione Descargar como Zip. O bien, seleccione 
Descargar para descargar todos los archivos de la carpeta seleccionada actualmente o el archivo seleccionado actualmente.
Este proceso no guarda ningún historial de cambios ni vínculos a otros artefactos. Si usa Git, clone los repositorios para conservar el historial completo del proyecto y todas las ramas.
Datos de compilación: para guardar registros y datos en las carpetas de compilación desplegables, consulte Visualización de los resultados de la compilación.
**Datos de seguimiento de elementos de trabajo: crear una consulta de trabajo y abrirla con Excel. Guarde la hoja de cálculo de Excel.
Este proceso no guarda ningún archivo adjunto, historial de cambios ni vínculos a otros artefactos.
Para obtener más información,consulte Información general sobre la protección de datos.
Eliminar proyecto
Use el explorador web para realizar una eliminación temporal. Después de 28 días, los proyectos se eliminan permanentemente si no se restauran en ese momento.
Inicie sesión en su organización (https://dev.azure.com/{yourorganization}).
Seleccione el 
Configuraciones de la organización.
Seleccione Proyectos, compruebe uno o varios proyectos que desea eliminar y, a continuación, seleccione Eliminar.
Confirme la eliminación escribiendo el nombre del proyecto y, a continuación, seleccione Eliminar en la pantalla emergente.
El proyecto se elimina y se puede restaurar hasta 28 días después. El proyecto eliminado se quita de la lista de proyectos.
La consola de administración solo se admite para servidores Azure DevOps locales.
Use la consola de administración de Azure DevOps para realizar una eliminación permanente. Los proyectos se eliminan permanentemente y no están sujetos a la restauración.
Con la consola de administración, puede eliminar un proyecto de una colección de proyectos. Después, debe eliminar manualmente los informes asociados y el portal del proyecto de SharePoint. O bien, puede usar la herramienta de línea de comandos TFSDeleteProject para eliminar todos los artefactos.
Si no es miembro de uno o varios de los siguientes grupos de administradores, obtenga permisos ahora:
- Grupo de administradores de Team Foundation (obligatorio).
- Grupo de administradores del sistema de SQL Server (obligatorio).
- Grupo de Administradores de Granjas para Productos de SharePoint (necesario cuando la implementación usa Productos de SharePoint).
Abra la consola de administración y elimine el proyecto de su colección de proyectos.
Elija si desea eliminar datos externos asociados al proyecto y, a continuación, inicie la acción de eliminación.
(Opcional) Para revisar el estado de la acción de eliminación, abra la pestaña Estado.
Para revisar los detalles de la acción de eliminación, puede abrir el archivo de registro desde la pestaña Estado o la pestaña Registros.
Puede eliminar un proyecto de equipo con el comando az devops project delete. Para empezar, consulte Introducción a Azure DevOps CLI.
az devops project delete --id
[--org]
[--yes]
Parámetros
- id: Obligatorio. Identificador del proyecto que desea eliminar. Para determinar el identificador de un proyecto, use el comando az devops project list.
- org: la URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante
az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado mediante git config. Ejemplo: --org https://dev.azure.com/MyOrganizationName/.
- Sí: No solicite confirmación.
Ejemplo
El siguiente comando elimina el proyecto de equipo con el identificador especificado sin solicitar confirmación.
az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes
Los comandos de la CLI de Azure DevOps no se admiten para Azure DevOps Server.
Eliminación de informes que permanecen después de eliminar un proyecto
Si su proyecto utilizó informes de SQL Server y no eliminó artefactos externos, puede eliminar los informes mediante el Administrador de informes de SQL Server. En la página de la colección de proyectos, elimine la carpeta que corresponde al proyecto eliminado.
Restauración de un proyecto eliminado
Si elimina accidentalmente un proyecto en Azure DevOps, puede restaurarlo en un plazo de 28 días a partir de su eliminación.
Inicie sesión en su organización (https://dev.azure.com/{Your_Organization}).
Seleccione el Configuraciones de la organización.
Seleccione Información general y desplácese hacia abajo hasta "proyectos eliminados recientemente".
Resalte el proyecto que desea restaurar y, a continuación, seleccione Restaurar.
Inicie sesión en su instancia (http://{ServerName:8080/tfs/}/{CollectionName}).
Elija Configuración de administración.
Seleccione Proyectos y desplácese hacia abajo hasta Proyectos eliminados recientemente.
Resalte el proyecto que desea restaurar y, a continuación, seleccione Restaurar.
Restauración de un proyecto con la API REST
Advertencia
Para restaurar un proyecto con un nombre existente, cambie el nombre del proyecto primero. Para cambiar el nombre del proyecto, escriba el texto siguiente en el cuerpo de la solicitud: "name":"new name".
Abra una ventana del explorador y escriba una dirección URL que use el siguiente formato:
http://ServerName:8080/tfs/DefaultCollection/ProjectName
Por ejemplo, para conectarse al servidor denominado FabrikamPrime, escriba: 'http://FabrikamPrime:8080/tfs/'.
El puerto predeterminado es 8080. Especifique el número de puerto y el directorio del servidor si no se usan los valores predeterminados.
Obtenga una lista de proyectos eliminados mediante la solicitud siguiente:
GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3
Restaure un proyecto eliminado mediante la siguiente solicitud:
PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
api-version=5.0-preview.3
Cuerpo de la solicitud
{
"state" : "wellFormed"
}
Restauración del proyecto con PowerShell
Ejecute el siguiente script de PowerShell para obtener una lista de proyectos eliminados y asegúrese de actualizar $collectionUrl.
$collectionUrl = "https://localhost/defaultcollection"
(irm -Uri "$collectionUrl/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
Use el siguiente script para restaurar un proyecto. Asegúrese de actualizar $collectionUrl y $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'
El proyecto y los datos asociados se restauran.
Preguntas más frecuentes
Consulte las siguientes preguntas más frecuentes sobre cómo eliminar proyectos en Azure DevOps.
P: Después de eliminar un proyecto, ¿por qué los elementos de trabajo de un proyecto restante siguen teniendo vínculos a los elementos de trabajo del proyecto eliminados?
R: Los vínculos de elemento de trabajo que apuntan a los elementos de trabajo del proyecto eliminados permanecerán hasta que el proyecto se elimine permanentemente. Una vez eliminado permanentemente el proyecto, los vínculos del elemento de trabajo se limpian automáticamente en un plazo de 24 horas. Si necesita que los vínculos del elemento de trabajo se limpien más rápido que eso, puede quitarlos manualmente del formulario del elemento de trabajo directamente.
P: He eliminado un proyecto en Azure DevOps, pero en Visual Studio Team Explorer todavía está ahí, ¿qué hago?
R: Espere 28 días hasta que el proyecto se elimine permanentemente.
Uso de la inteligencia artificial para administrar la eliminación y restauración de proyectos
Si usa GitHub Copilot, el Azure DevOps servidor MCP puede ayudarle a eliminar, restaurar y limpiar proyectos de Azure DevOps de forma segura a través de mensajes de lenguaje natural.
Ejemplo de solicitudes de eliminación y restauración del proyecto
| tarea |
Mensaje de ejemplo |
| Planear una eliminación segura de un proyecto |
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 |
| Restauración de un proyecto eliminado accidentalmente |
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 |
| Limpieza después de una migración |
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 proyectos para determinar candidatos a eliminación |
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 |
| Automatización de la eliminación de proyectos mediante la 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 con vínculos rotos en elementos de trabajo |
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 |
Sugerencia
Para obtener los mejores resultados, use estas solicitudes en modo de agente con el servidor MCP de Azure DevOps conectado. Personalice las indicaciones con el nombre de proyecto, la organización o el escenario de migración específicos.
Contenido relacionado
