Comando Delete (Control de versiones de Team Foundation)

  • Artículo

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

Visual Studio 2019 | Visual Studio 2022

El comando delete quita archivos y carpetas del servidor de Azure DevOps y los elimina del disco.

Nota:

Los resultados de este comando no son visibles en otras áreas de trabajo hasta que se realiza una operación de inserción en el repositorio. Para más información, vea Desarrollo de código y administración de cambios pendientes.

Requisitos previos

Para usar el comando delete, debe tener el permiso Extraer del repositorio establecido en Permitir. Si incluye la opción /lock con un valor distinto de none, debe tener el permiso Bloquear establecido en Permitir. También debe ser propietario del área de trabajo o tener establecido el permiso global Administrar áreas de trabajo en Permitir. Para obtener más información, vea Permisos predeterminados de TFVC.

Sintaxis

tf delete [/lock:(none|checkin|checkout)] [/recursive] [/login:username,[password]] itemspec

Parámetros

Argumentos

Argument

Descripción

<itemspec>

Identifica el archivo o la carpeta que se va a eliminar del servidor de Azure DevOps. Para obtener más información sobre cómo TFVC analiza un itemspec para determinar qué elementos están dentro del ámbito, vea Uso de opciones para modificar cómo funciona un comando.

Nota:

Puede especificar más de un argumento itemspec.

<username>

Proporciona un valor a la opción /login. Puede especificar un valor de nombre de usuario como DOMAIN\username o username.

Opciones

Opción

Descripción

/lock

Impide que otros usuarios puedan insertar en el repositorio o extraer del repositorio los elementos especificados. Para obtener más información, vea Descripción de los tipos de bloqueo.

Opciones de bloqueo:

  • none
    Predeterminada. No se aplica ningún bloqueo. Si ha colocado un bloqueo en el archivo especificado, esta opción lo quita. No quita un bloqueo colocado por otra persona.

  • checkin
    Otros usuarios pueden extraer del repositorio los elementos especificados, pero no pueden insertar en el repositorio las revisiones de archivos bloqueados hasta que libere el bloqueo mediante una inserción en el repositorio. Si cualquier otro usuario ha bloqueado alguno de los elementos especificados, se produce un error en la operación de bloqueo.

  • checkout
    Impide que otros usuarios puedan insertar en el repositorio o extraer del repositorio cualquiera de los elementos especificados hasta que libere el bloqueo realizando una inserción en el repositorio. Si cualquier otro usuario ha bloqueado alguno de los elementos especificados, se produce un error en la operación de bloqueo.

/recursive

Elimina todos los archivos, o carpetas y subcarpetas, que coinciden con el elemento itemspec del directorio especificado.

  • tf delete <folder1>\<folder2> /recursive elimina todos los archivos y subdirectorios que contienen <folder1>\<folder2> y <folder1>\<folder2>.
  • tf delete <folder1>\<folder2> <filespec> /recursive elimina todos los archivos y subdirectorios que coinciden con el elemento filespec contenido en <folder1>\<folder2> y cada uno de sus subdirectorios, así como todos los archivos y subdirectorios contenidos en cualquier directorio que coincida con filespec.

Por ejemplo, en un área de trabajo que contiene lo siguiente:

Folder1\AVeryLongDirectoryName con algunos archivos dentro y Folder1\Folder2\AVeryImportantFile.txt,

tf delete Folder1 AVer* /recursive

elimina Folder1\AVeryLongDirectoryName y todos sus archivos y también elimina Folder1\Folder2\AVeryImportantFile.txt porque coincide con el carácter comodín.

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps.

Observaciones

El comando delete registra un cambio pendiente de tipo delete en el área de trabajo para los elementos que especifique. Al confirmar un cambio pendiente de tipo delete en el servidor de Azure DevOps mediante el comando checkin, TFVC quita el elemento del servidor de Azure DevOps, pero no lo elimina permanentemente. Puede buscar elementos eliminados en el servidor de Azure DevOps mediante el comando dir y puede restaurar elementos eliminados mediante el comando Undelete.

Si ha eliminado un elemento del área de trabajo pero no ha insertado en el repositorio el cambio, puede restaurar el elemento en el área de trabajo y quitar la eliminación de la lista de cambios pendientes mediante el comando Undo.

No se puede eliminar un elemento para el que existe otro cambio pendiente. Por ejemplo, no se puede eliminar un archivo que se ha extraído del repositorio. Para eliminar estos elementos, debe deshacer el cambio pendiente actual mediante el comando undo.

Al insertar en el repositorio una eliminación pendiente, TFVC marca el archivo como eliminado en el servidor de Azure DevOps. Posteriormente, al ejecutar un objeto get del elemento de otras áreas de trabajo, usted u otros usuarios eliminan el elemento de esas áreas de trabajo.

Cuando itemspec especifica una carpeta, TFVC elimina todos sus archivos y subcarpetas, y los archivos que contienen, de forma predeterminada.

Para obtener más información sobre cómo usar la utilidad de línea de comandos tf, vea Uso de comandos de control de versiones de Team Foundation.

Ejemplos

En el ejemplo siguiente se elimina 314.cs en el disco de la carpeta del área de trabajo local especificada y, después, al insertar en el repositorio el cambio, se quita 314.cs del sistema de control de versiones de forma no permanente.

tf delete 314.cs