Comando unshelve (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 unshelve de Control de versiones de Team Foundation (TFVC) restaura revisiones de archivos preparados para confirmar, notas de inserción en el repositorio, comentarios y asociaciones de elementos de trabajo en el área de trabajo actual. También se puede usar el comando unshelve para quitar del servidor un conjunto de cambios agregados pendientes de confirmación.

Requisitos previos

  • Para usar el comando unshelve:
    • Debe tener el permiso Leer establecido en Permitir.
    • Debe tener el permiso Extraer del repositorio para los elementos del conjunto de cambios agregados pendientes de confirmación establecido en Permitir.
  • Para eliminar un conjunto de cambios agregados pendientes de confirmación, debe ser su propietario o tener el permiso global Administrar cambios aplazados establecido en Permitir.

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

Sintaxis

tf unshelve [/move] [<shelveset-name>[;<owner-name>]] <item-spec> 
[/recursive] [/noprompt][/login:<username>,[<password>]]

Parámetros

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

Argumentos

Argument

Descripción

<shelveset-name>

Especifica el nombre del conjunto de cambios agregados pendientes de confirmación que se va a restaurar.

<owner-name>

Especifica el nombre de usuario del propietario del conjunto de cambios agregados pendientes de confirmación.

<item-spec>

Identifica las revisiones agregadas de archivo o carpeta pendientes de confirmación que se van a recuperar en el área de trabajo actual. Si este parámetro no está incluido, se recuperan de forma predeterminada todos los cambios pendientes del conjunto especificado de cambios agregados pendientes de confirmación. No se permiten rutas de acceso de servidor.

Para obtener más información sobre la manera en que TFVC analiza los valores <item-spec> a fin de determinar qué elementos están dentro del ámbito, vea Uso de comandos de Control de versiones de Team Foundation: uso de opciones para modificar el funcionamiento de un comando.

Nota:

Puede especificar más de un argumento <item-spec>.

<username>

Proporciona un valor a la opción /login. Puede especificar este valor como DOMAIN\<username> o <username>.

<password>

Proporciona un valor a la opción /login.

Opciones

Opción

Descripción

/move

Elimina del servidor de Azure DevOps el conjunto especificado de cambios agregados pendientes de confirmación después de recuperarlo correctamente. Esta opción no se puede combinar con un valor <item-spec>.

También puede eliminar un conjunto de cambios agregados pendientes de confirmación mediante el comando shelve.

/recursive

Especifica que el valor <item-spec> debe coincidir de forma recursiva.

/noprompt

Especifica que TFVC no debe solicitar una entrada.

/login

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

Observaciones

El comando unshelve de la utilidad de línea de comandos tf recupera del servidor de Azure DevOps todas las revisiones de archivos preparados para confirmar, o bien un subconjunto definido de todas las revisiones de archivos preparados para confirmar. Después, el comando almacena las revisiones en el área de trabajo actual.

Para recuperar un elemento con cambios agregados pendientes de confirmación, dicho elemento no debe tener revisiones pendientes en el área de trabajo de destino.

Al recuperar un conjunto de cambios agregados pendientes de confirmación, TFVC restaura cada revisión preparada para confirmar en el área de trabajo de destino como un cambio pendiente, siempre y cuando la revisión no entre en conflicto con un cambio que ya esté pendiente en el área de trabajo. Para obtener más información sobre lo que sucede durante el proceso de recuperar cambios agregados pendientes de confirmación, consulte Trabajo con conjuntos de cambios agregados pendientes de confirmación.

Puede usar el comando unshelve para restaurar revisiones de archivos individuales desde un conjunto de cambios agregados pendientes de confirmación en el área de trabajo. Después de ejecutar el comando unshelve, ejecute el comando get para conciliar los cambios que se insertaron en el repositorio del servidor desde que se creó el conjunto de cambios agregados pendientes de confirmación.

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.

Reciclaje de cambios preparados para confirmar

Si quiere integrar revisiones preparadas para confirmar en el área de trabajo actual para realizar revisiones continuas, recupere el conjunto deseado de cambios agregados pendientes de confirmación. Se recomienda obtener también la versión más reciente de los archivos con control de versiones después de recuperar cambios agregados pendientes de confirmación.

Revisión y recuperación de cambios agregados pendientes de confirmación del código de otro usuario

También puede recuperar un conjunto de cambios agregados pendientes de confirmación para revisar los cambios en el área de trabajo de otro usuario. Para recuperar cambios agregados pendientes de confirmación por este motivo, tiene dos opciones:

  • La primera opción es adecuada cuando no se han revisado los elementos preparados para confirmar y los elementos relacionados, o solo se han revisado ligeramente desde que se creó el conjunto de cambios agregados pendientes de confirmación. En este caso, puede recuperar la versión base de todos los elementos relacionados del área de trabajo del propietario del conjunto de cambios agregados pendientes de confirmación. Para usar esta opción, ejecute una variación del comando siguiente: tf get \* /version;W<workspace-name>, donde <workspace-name> es el nombre del área de trabajo desde la que el otro usuario creó el conjunto de cambios agregados pendientes de confirmación.

  • La segunda opción es adecuada cuando ha transcurrido un tiempo considerable o se han realizado varias revisiones en el área de trabajo desde que se creó el conjunto de cambios agregados pendientes de confirmación. En este caso, puede recuperar del servidor la versión de todos los elementos relacionados en la fecha y hora en que se creó el conjunto de cambios agregados pendientes de confirmación.

Para recuperar un cambio preparado para confirmar de otro usuario, anexe el nombre de usuario al nombre del conjunto de cambios agregados pendientes de confirmación. Solo podrá quitar del servidor de Azure DevOps un conjunto de cambios agregados pendientes de confirmación creado por otro usuario si tiene el permiso AdminShelvedChangesets.

Si intenta recuperar un elemento con un cambio agregado pendiente de confirmación en el área de trabajo de destino, TFVC no combina las diferencias entre los elementos y no recupera la revisión en el área de trabajo.

Puede eliminar un conjunto de cambios agregados pendientes de confirmación mediante tf shelve /delete. Para obtener más información, consulte Comando shelve. Para eliminar automáticamente un conjunto de cambios agregados pendientes de confirmación después de recuperarlo al completo, use tf unshelve /move.

Ejemplos

En el ejemplo siguiente se abre el cuadro de diálogo Recuperar cambios agregados pendientes de confirmación para que pueda buscar y recuperar un conjunto de cambios agregados pendientes de confirmación en el área de trabajo actual. El cuadro de diálogo también ofrece una opción para eliminar el conjunto de cambios agregados pendientes de confirmación cuando finalice la operación de recuperación.

c:\>tf unshelve

En el ejemplo siguiente se recupera el conjunto de cambios agregados pendientes de confirmación buddytest_1256 en el área de trabajo actual y se quita de Azure DevOps Server:

c:\>tf unshelve /move buddytest_1256