Compartir a través de

Comando Unshelve (Control de versiones de Team Foundation)

  • Artículo

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

Visual Studio 2019 | de Visual Studio 2022

El comando Control de versiones de Team Foundation (TFVC) unshelve restaura las revisiones de archivos con formato shelved, las notas de entrada, los comentarios y las asociaciones de elementos de trabajo en el área de trabajo actual. También puede usar el comando unshelve para quitar un conjunto de estantes existente del servidor.

Prerrequisitos

  • Para usar el comando unshelve:
    • Establezca el permiso lectura en Permitir.
    • Tenga el permiso Desactive para los elementos del conjunto de estantes establecido en Permitir.
  • Para eliminar un conjunto de estantes, sea su propietario o tenga los cambios de administración de administrar conjunto de permisos globales en Permitir.

Para obtener más información, consulte permisos predeterminados de TFVC.

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

de argumentos de

descripción

<shelveset-name>

Especifica el nombre del conjunto de estantes que se va a restaurar.

<owner-name>

Especifica el nombre de usuario del propietario del conjunto de estantes.

<item-spec>

Identifica las revisiones de archivo o carpeta que se van a deshacer en el área de trabajo actual. Si no se incluye este parámetro, todos los cambios pendientes en el conjunto de estantes especificados no se descarguen, de forma predeterminada. No se permiten rutas de acceso de servidor.

Para obtener más información sobre cómo TFVC analiza <item-spec> valores para determinar qué elementos están dentro del ámbito, consulte Usar comandos de control de versiones de Team Foundation: Usar opciones para modificar cómo funciona 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

de opción de

descripción

/move

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

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

/recursive

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

/noprompt

Especifica que TFVC no debe solicitar la 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 de tf recupera todas las revisiones de archivos con formato shelved o un subconjunto definido de todas las revisiones de archivos con formato shelved del servidor de Azure DevOps. A continuación, el comando almacena las revisiones en el área de trabajo actual.

Para deshacer un elemento, no debe haber revisiones pendientes en él en el área de trabajo de destino.

Al deshacer un conjunto de estantes, TFVC restaura cada revisión 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 estaba pendiente en el área de trabajo. Para obtener más información sobre lo que sucede durante el proceso de deshacer, consulte Trabajar con conjuntos de estantes.

Puede usar el comando unshelve para restaurar revisiones de archivos individuales desde un conjunto de estantes al área de trabajo. Después de ejecutar el comando unshelve, ejecute el comando get para conciliar los cambios que se han protegido en el servidor desde que se creó el conjunto de estantes.

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

Cambios archivados de reciclaje

Si desea integrar revisiones archivadas en el área de trabajo actual para realizar revisiones en curso, desactive el conjunto de estantes deseado. Como procedimiento recomendado, obtenga también la versión más reciente de los archivos controlados por versiones después de deshacerse.

Deshacer y revisar el código de otro usuario

También puede deshacer un conjunto de estantes para revisar los cambios del área de trabajo de otro usuario. Para deshacer por este motivo, tiene dos opciones:

  • La primera opción es adecuada cuando no se han revisado los artículos con formato y los elementos relacionados, o solo se han revisado ligeramente desde que se creó el conjunto de estantes. En este caso, puede recuperar la versión base de todos los elementos relacionados del área de trabajo del propietario del conjunto de estantes. Para usar esta opción, ejecute una variación del siguiente comando: 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 estantes.

  • La segunda opción es adecuada cuando se ha pasado una cantidad significativa de tiempo o se han realizado varias revisiones en el área de trabajo desde que se creó el conjunto de estantes. En este caso, puede recuperar la versión de todos los elementos relacionados del servidor a partir de la fecha y hora en que se creó el conjunto de estantes.

Puede anular el cambio de la carpeta de otro usuario anexando el nombre de usuario al nombre del conjunto de estantes. Sin embargo, solo puede quitar un conjunto de estantes del servidor de Azure DevOps creado por otro usuario si tiene el permiso de AdminShelvedChangesets.

Si intenta deshacer un elemento con un cambio pendiente 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 estantes mediante tf shelve /delete. Para obtener más información, vea comando Shelve. Para eliminar automáticamente un conjunto de estantes después de deshacer todo el conjunto de estantes, use tf unshelve /move.

Ejemplos

En el ejemplo siguiente se abre el cuadro de diálogo Deshacer para que pueda encontrar y deshacer un conjunto de estantes en el área de trabajo actual. También tiene una opción en el cuadro de diálogo para que el conjunto de estantes se elimine cuando finalice la operación de deshacer.

c:\>tf unshelve

En el ejemplo siguiente se quita el conjunto de estantes buddytest_1256 en el área de trabajo actual y se quita de Azure DevOps Server:

c:\>tf unshelve /move buddytest_1256