Comando Shelve (Control de versiones de Team Foundation)
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) shelve almacena un conjunto de cambios pendientes, junto con notas pendientes de entrada, un comentario y una lista de elementos de trabajo asociados en un servidor de Azure DevOps sin comprobarlos realmente.
Prerrequisitos
Si desea usar el comando shelve para eliminar un conjunto de estantes, ser propietario de un conjunto de estantes o los cambios de administración de administrar cambios permiso deben establecerse en Permitir. Para obtener más información, consulte permisos predeterminados de TFVC.
Sintaxis
tf shelve [/replace] [/comment:("comment"|@commentfile)] [shelvesetname] [/validate][/noprompt] [/login:username,[password]]
tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)]
[/recursive] [shelvesetname] itemspec [/validate] [/noprompt] [/login:username,[password]]
tf shelve /delete shelvesetname[;owner] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parámetros
Argumentos
| de argumentos de |
descripción |
|---|---|
<commentfile> |
Especifica una ruta de acceso del sistema de archivos de un archivo desde el que se deben leer los comentarios del conjunto de estantes. |
<comment> |
Especifica el comentario del conjunto de estantes. |
<itemspec> |
Identifica los archivos o carpetas que se van a archivar. De forma predeterminada, todos los cambios pendientes en el área de trabajo actual se archivan si no se especifica este parámetro. Para obtener más información sobre cómo Team Foundation analiza el itemspec para determinar qué elementos están dentro del ámbito, consulte Usar opciones para modificar cómo funciona un comando. |
<shelvesetname> |
Especifica un nombre por el que se puede recuperar el conjunto de estantes del servidor de Azure DevOps. Puede especificar una combinación existente de shelvesetname y owner, pero solo si también se especifica /replace.Debe proporcionar un valor para este parámetro. |
<owner> |
Identifica el propietario actual o previsto del conjunto de estantes por nombre de usuario. De forma predeterminada, el usuario actual tiene asignada la propiedad del conjunto de estantes si no se especifica uno. |
<username> |
Proporciona un valor a la opción /login. Puede especificar un valor de nombre de usuario como DOMAIN\username o username. |
<TeamProjectCollectionUrl> |
Dirección URL de la colección de proyectos que contiene los archivos o carpetas que desea archivar, por ejemplo, http://myserver:8080/tfs/DefaultCollection/. |
Opciones
| de opción de |
descripción |
|---|---|
/new |
El estado seleccionado de cada cambio pendiente, tal como se muestra en el cuadro de diálogo Desactive visual Studio /new desactiva estos metadatos de registro antes de iniciar la sesión. |
/move |
Quita los cambios pendientes del área de trabajo después de que la operación shelve se realice correctamente. |
/replace |
Reemplaza el conjunto de estantes existente por el mismo nombre y propietario que el especificado. |
/delete |
Elimina el conjunto de estantes especificado. Solo se puede combinar la opción /server con esta opción. Si no incluye la opción /noprompt, aparece un mensaje de confirmación cuando se especifica la opción /delete. |
/comment |
Agrega un comentario especificado que describe los cambios archivados. |
/recursive |
Repisa todos los elementos de la carpeta del conjunto de estantes especificado, sus subcarpetas y todos los elementos que contiene si el itemspec que proporcione es una carpeta. |
/noprompt |
Suprime las solicitudes de entrada de usted. |
/validate |
Esta opción activa la casilla Evaluar directivas y notas de entrada antes de archivar casilla en el cuadro de diálogo Shelve - Archivos de origen cuando se abre. Cuando se activa la casilla de validación, el cuadro de diálogo evalúa las directivas de protección y comprueba que se han rellenado las notas de la comprobación. Esta opción es útil cuando otra persona envía los cambios para su revisión y comprobación. No es válido cuando se combina con /noprompt. |
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps Server. |
/collection |
Especifica la colección de proyectos. |
Observaciones
El comando shelve de la utilidad de línea de comandos tf realiza una copia de seguridad de los cambios pendientes, una lista de elementos de trabajo asociados, notas de comprobación en curso y comentarios en un conjunto de estantes en el servidor de Azure DevOps. Un conjunto de es muy similar a un conjunto de cambios que no está confirmado en el servidor. Al igual que un conjunto de cambios, cualquier usuario que tenga permisos suficientes puede recuperar un conjunto de estantes del servidor en un área de trabajo local.
El archivador es una alternativa a la comprobación de los cambios pendientes que no se han probado lo suficiente. Use el archivador cuando quiera interrumpir el trabajo para:
Comparta un conjunto de archivos de trabajo locales con otro desarrollador o evaluador sin proteger los cambios en el servidor de control de versiones.
Deje de lado un grupo de cambios pendientes temporalmente sin protegerlos, por lo que puede trabajar en un problema de prioridad más alta. Después de completar el trabajo en la tarea de alta prioridad, puede restaurar los cambios archivados mediante el comando Unshelve .
Si incluye la opción de /move, el comando shelve revierte cada revisión de archivo con formato shelved a la versión del área de trabajo base de que es la última versión recuperada del servidor al área de trabajo actual. En concreto, para todos los elementos que se reducen, la opción /move:
Usa
Undopara deshacer los cambios que se han archivado. Los archivos que estaban pendientes se eliminan del área de trabajo.Recupera las versiones del área de trabajo base de todos los archivos para los que existen ediciones pendientes desde el servidor en el área de trabajo actual.
Marca todos los elementos del área de trabajo actual de solo lectura.
Si incluye la opción /delete, TFVC quita permanentemente el conjunto de estantes especificado del servidor de Azure DevOps.
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.
Ejemplos
En el ejemplo siguiente se crea un nuevo conjunto de estantes en el servidor de Azure DevOps denominado Reflector_BuddyTest, se asigna la propiedad al usuario Pat, se devuelven todos los elementos del área de trabajo actual a la versión más reciente descargada durante la última operación de get y se establece un estado de solo lectura:
c:\projects> tf shelve Reflector_BuddyTest;Pat /move
En el ejemplo siguiente se elimina el conjunto de estantes existente new-feature del servidor, se crea un nuevo conjunto de estantes con ese nombre y se conservan todos los cambios pendientes en el área de trabajo actual:
c:\projects> tf shelve new-feature /replace
En el ejemplo siguiente se crea un conjunto de estantes denominado HelloWorld_TestMe que incluye todos los cambios pendientes en todos los archivos de .cs del C:\projects carpeta de trabajo y sus subcarpetas:
c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive
En el ejemplo siguiente se elimina el conjunto de HelloWorld_24 estantes:
c:\projects> tf shelve HelloWorld_24 /delete