Unshelve (Comando)

Restaura revisiones de archivo aplazadas, notas de protección, comentarios y asociaciones de elementos de trabajo al área de trabajo actual o quita del servidor un conjunto de cambios aplazados existente.

Permisos necesarios

Para utilizar el comando unshelve, el permiso Lectura debe estar establecido en Permitir y el permiso Desproteger para los elementos del conjunto de cambios aplazados debe estar establecido en Permitir. Además, para eliminar un conjunto de cambios aplazados, debe ser su propietario o tener el permiso Administrar cambios aplazados global establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.

tf unshelve [/move] [shelvesetname[;username]] itemspec 
[/recursive] [/noprompt][/login:username,[password]]

Parámetros

Argumento

Descripción

shelvesetname

Nombre del conjunto de cambios aplazados que se va a restaurar.

ownername

Nombre del propietario del conjunto de cambios aplazados.

Itemspec

Identifica las revisiones de archivo o carpeta cuyos cambios aplazados se van a retomar en el área de trabajo actual. Si este parámetro no se incluye, se retoman todos los cambios pendientes en el conjunto de cambios aplazados especificado de forma predeterminada. No se permiten las rutas de acceso del servidor.

Para obtener más información acerca de cómo Team Foundation analiza itemspecs para determinar qué elementos se encuentran en ese ámbito, vea Opciones de la línea de comandos.

NotaNota
Puede especificar más de un argumento Itemspec.

username

Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario.

Opción

Descripción

/move

Elimina el conjunto de cambios aplazados especificado del servidor de control de versiones de Team Foundation si se realiza correctamente la operación de retomar los cambios aplazados. Esta opción no se puede combinar con itemspec.

También puede eliminar un conjunto de cambios aplazados mediante el comando shelve.

/recursive

Si se especifica, se buscan las coincidencias con itemspec de forma recursiva.

/noprompt

Si se especifica, no se muestran mensajes de solicitud de información.

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server.

Comentarios

El comando unshelve de la utilidad de línea de comandos tf recupera todas las revisiones de archivo aplazadas o un subconjunto definido de todas las revisiones de archivo aplazadas del servidor Team Foundation en el área de trabajo actual.

Para retomar los cambios aplazados de un elemento, no debe haber ninguna revisión pendiente para él en el área de trabajo de destino.

Cuando retoma los cambios aplazados de un conjunto, Team Foundation restaura cada revisión aplazada en el área de trabajo de destino como un cambio pendiente, siempre que la revisión no entre en conflicto con un cambio que ya estaba pendiente en el área de trabajo. Para obtener más información sobre lo que sucede durante el proceso de retomar cambios aplazados, vea Trabajar con conjuntos de cambios aplazados.

Puede utilizar el comando unshelve para restaurar revisiones de archivo individuales de un conjunto de cambios aplazados en su área de trabajo. Debe ejecutar el comando get después de retomar los cambios aplazados para reconciliar cualquier cambio archivado en el servidor desde que se creó el conjunto de cambios aplazados.

Para obtener más información sobre cómo buscar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.

Reciclar los cambios aplazados

Si desea integrar las revisiones aplazadas en su área de trabajo actual para realizar revisiones continuadas, retome el conjunto de cambios aplazados deseado. Como procedimiento recomendado, obtenga también la versión más reciente de los archivos con control de versiones después de retomar los cambios aplazados.

Retomar los cambios aplazados y revisar el código de otro usuario

También puede retomar un conjunto de cambios aplazados para revisar los cambios del área de trabajo de otro usuario. Al retomar los cambios aplazados por esta razón, tiene dos opciones.

  • Si no se han revisado los elementos aplazados y los elementos con los que están relacionados, o si sólo se han revisado ligeramente desde que se creó el conjunto de cambios aplazados, puede recuperar la versión base de todos los elementos relacionados del área de trabajo del propietario del conjunto de cambios aplazados. Para ello, utilice alguna variación del comando siguiente: tf get * /version;Wworkspacename, donde workspacename es el nombre del área de trabajo desde la que otro usuario creó el conjunto de cambios aplazados.

  • Si ha transcurrido bastante tiempo o si ha habido varias revisiones en el área de trabajo desde que se creó el conjunto de cambios aplazados, recupere la versión de todos los elementos relacionados del servidor en la fecha y hora en las que se creó el conjunto de cambios aplazados.

Puede retomar los cambios aplazados de otro usuario anexando el nombre de usuario al nombre del conjunto de cambios aplazados. Sin embargo, sólo puede quitar de Team Foundation Server un conjunto de cambios aplazados creado por otro usuario si tiene el permiso AdminShelvedChangesets.

Si intenta retomar los cambios aplazados de un elemento para el que existe un cambio pendiente en el área de trabajo de destino, Team Foundation no combina las diferencias entre los elementos y no recupera la revisión en su área de trabajo.

Puede eliminar un conjunto de cambios aplazados utilizando tf shelve /delete. Para obtener más información, vea Shelve (Comando). Para eliminar automáticamente un conjunto de cambios aplazados después de retomar el conjunto de cambios aplazados completo, utilice tf unshelve /move.

Ejemplos

El ejemplo siguiente abre el cuadro de diálogo Retomar cambios aplazados para que pueda buscar y retomar un conjunto de cambios aplazados en el área de trabajo actual. En el cuadro de diálogo también hay una opción para eliminar el conjunto de cambios aplazados cuando finaliza la operación de retomarlos.

c:\>tf unshelve

El ejemplo siguiente retoma los cambios aplazados del conjunto buddytest_1256 en el área de trabajo actual y lo quita de Team Foundation Server.

c:\>tf unshelve /move buddytest_1256

Vea también

Tareas

Almacenar cambios pendientes y retomar cambios aplazados

Referencia

Sintaxis de la línea de comandos (Control de versiones)

Shelve (Comando)

Changeset (Comando)

Conceptos

Trabajar con conjuntos de cambios aplazados

Otros recursos

Comandos de la utilidad Tf de la línea de comandos