Comando undelete (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 undelete de Control de versiones de Team Foundation (TFVC) restaura los elementos que se han eliminado anteriormente.

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 undelete:

  • 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.
  • Debe ser propietario del área de trabajo o tener establecido el permiso global Administrar áreas de trabajo en Permitir.

Para más información, vea Permisos predeterminados de TFVC.

Sintaxis

tf undelete [/noget] [/lock:(none|checkin|checkout)] 
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]

Parámetros

En las secciones siguientes se describen los argumentos y las opciones del comando undelete.

Argumentos

Argument Descripción
<item-specification> Identifica el archivo o la carpeta que se va a restaurar. Para más información sobre cómo TFVC analiza los valores <item-specification> para determinar qué elementos están dentro de su ámbito, vea Uso de comandos de control de versiones de Team Foundation.
<deletion-ID> Especifica un identificador único que elimina la ambigüedad de varios elementos eliminados que tienen el mismo nombre.
<username> Proporciona un valor a la opción /login. Puede especificar este valor como DOMAIN\<username> o <username>.

Opciones

Opción

Descripción

/noget

Restaura el elemento eliminado en el área de trabajo. Pendiente de la finalización de una operación de inserción en el repositorio, esta opción restaura el elemento en el servidor, pero no recupera inmediatamente una copia física del elemento en el disco.

/lock

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

Opciones de bloqueo:

  • None: esta opción es el valor predeterminado. No se aplica ningún bloqueo.
  • 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 la inserción en el repositorio de los archivos bloqueados. Si otro usuario ha bloqueado alguno de los elementos especificados, se produce un error en la operación de bloqueo.
  • Checkout: esta opción impide que otros usuarios puedan insertar en el repositorio o extraer del repositorio cualquiera de los elementos especificados hasta que libere el bloqueo mediante la inserción en el repositorio de los archivos bloqueados. Si otro usuario ha bloqueado alguno de los elementos especificados, se produce un error en la operación de bloqueo.

/recursive

Restaura todos los archivos y subcarpetas desde el directorio especificado.

/login

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

Observaciones

El comando undelete de la característica de línea de comandos tf programa archivos o carpetas especificados para la restauración pendiente de la finalización de una operación de inserción en el repositorio. También recupera los elementos especificados del servidor al disco local a menos que incluya explícitamente la opción /noget.

Cuando se han eliminado de la misma carpeta de servidor archivos o carpetas que tienen el mismo nombre, debe incluir un valor para el parámetro <deletion-ID>, a fin de indicar qué elementos eliminados quiere restaurar. Puede obtener <deletion-ID> mediante el comando dir.

Si quiere cambiar un archivo después de restaurarlo, debe extraerlo del repositorio para su edición mediante el comando checkout como de costumbre.

Cuando el valor <item-specification> especifica una carpeta, TFVC restaura de forma predeterminada todos los archivos y subcarpetas de la carpeta y los archivos que contienen. Si no quiere restaurar todos los elementos de una carpeta, primero debe recuperar la carpeta y sus elementos y, después, eliminar los que no quiera conservar.

Para 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 restaura 314.cs a la carpeta de servidor de la que se ha eliminado 314.cs. El comando también recupera una copia de solo lectura de la versión más reciente del área de trabajo actual.

C:\projects>tf undelete c:\math\314.cs

En el ejemplo siguiente se muestran los identificadores de eliminación de todos los elementos del servidor que se han eliminado más de una vez:

c:\projects>tf dir $/ /deleted

La salida del comando anterior podría ser similar a la del ejemplo siguiente:

$/projects/math/314.cs;X10
$/projects/math/314.cs;X11

En el ejemplo siguiente se restaura la versión X11 de 314.cs a la carpeta de servidor de la que se ha eliminado el archivo. El comando también recupera una copia de solo lectura de la versión más reciente del área de trabajo actual.

c:\projects>tf undelete 314.cs;X11