Comando shelve

Artículo
10/07/2008

Actualización: noviembre 2007

Almacena un conjunto de cambios pendientes, junto con las notas de cambios pendientes, un comentario y una lista de elementos de trabajo asociados, en Team Foundation Server sin protegerlos en el servidor del control de versiones.

Permisos necesarios

Para utilizar el comando shelve, debe ser propietario del conjunto de cambios aplazados o tener el permiso Administrar cambios aplazados establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.

tf shelve  [/replace] [/comment:("comment"|@commentfile)] [shelvesetname[;owner] [/validate]

tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)] 
[/recursive] shelvesetname[;owner] itemspec [/validate]

tf shelve /delete [/server:servername] shelvesetname[;owner] [/validate]

Parámetros

Argumento	Descripción
commentfile	Especifica una ruta de acceso del sistema de archivos para un archivo del que se deben leer los comentarios para el conjunto de cambios aplazados.
comment	Especifica el comentario para el conjunto de cambios aplazados.
servername	Valor proporcionado por el usuario para la opción /server.
itemspec	Identifica los archivos o carpetas cuyos cambios se van a aplazar. De forma predeterminada, se aplazan todos los cambios pendientes en el área de trabajo actual si no se especifica este parámetro. 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.
shelvesetname	Especifica un nombre por el que el conjunto de cambios aplazados se puede recuperar en el servidor Team Foundation. Puede especificar una combinación existente de shelvesetname y owner , pero sólo si también se especifica /replace . Debe proporcionar un valor para este parámetro.
owner	Identifica el propietario actual o deseado del conjunto de cambios aplazados por nombre de usuario. De forma predeterminada, el usuario actual tiene asignada la propiedad del conjunto de cambios aplazados si no se especifica uno.

Opción	Descripción
/move	Quita los cambios pendientes del área de trabajo después de que la operación de aplazamiento tenga éxito.
/replace	Reemplaza el conjunto de cambios aplazados existente que tiene el mismo nombre y propietario que el especificado.
/delete	Elimina los conjuntos de cambios aplazados especificados. Sólo la opción /server se puede combinar 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 aplazados.
/recursive	Aplaza los cambios en todos los elementos de la carpeta de conjunto de cambios aplazados especificada, sus subcarpetas y todos los elementos que contiene si el itemspec proporcionado es una carpeta.
/server	Especifica el servidor Control de versiones de Team Foundation en el que se va a crear, modificar o eliminar el conjunto de cambios aplazados especificado.
/noprompt	Suprime todos los mensajes de solicitud de datos.
/validate	Sólo es válido cuando no se combina con /noprompt. Esta opción activa la casilla Validación en el cuadro de diálogo Aplazar - Archivos de código fuente cuando se abre. Cuando la casilla Validación está activada, el cuadro de diálogo evalúa las directivas de protección y comprueba si se han rellenado las notas de protección requeridas. Esta opción es útil cuando se los cambios se van a entregar para que los revise y proteja otra persona.

Comentarios

El comando shelve de la utilidad de línea de comandos tf crea una copia de seguridad de los cambios pendientes, una lista de los elementos de trabajo asociados, notas de protección en curso y comentarios en un conjunto de cambios aplazados en el servidor Team Foundation Server. Un conjunto de cambios aplazados es muy similar a un conjunto de cambios que no se ha confirmado en el servidor. Al igual que ocurre con un conjunto de cambios, cualquier usuario que tenga los permisos necesarios puede recuperar un conjunto de cambios aplazados del servidor en un área de trabajo local.

El aplazamiento es una alternativa a la protección de cambios pendientes que no se han probado suficientemente. Utilice el aplazamiento cuando desee interrumpir su trabajo:

Comparta un conjunto de archivos de trabajo locales con otro programador o evaluador sin proteger sus cambios en el servidor del control de versiones.
Deje de lado temporalmente un grupo de cambios pendientes sin protegerlos para que pueda trabajar mientras tanto en un problema de mayor prioridad. Después de finalizar el trabajo en la tarea de mayor prioridad, puede restaurar sus cambios aplazados mediante el Comando unshelve.

Si incluye la opción /move, el comando shelve devuelve todas las revisiones de archivo aplazadas a sus versiones de área de trabajo base, que es la última versión recuperada del servidor en el área de trabajo actual. Específicamente, la opción /move garantiza que para todos los elementos que aplaza se produce lo siguiente:

Utiliza Undo para deshacer los cambios que se aplazaron. Los archivos que tenían cambios pendientes de agregar se eliminan del área de trabajo.
Las versiones del área de trabajo base de todos los archivos para los que existen ediciones pendientes se recuperan del servidor en el área de trabajo actual.
Todos los elementos del área de trabajo actual se marcan como de sólo lectura.

Si incluye la opción /delete , Team Foundation quita permanentemente el conjunto de cambios aplazados especificado del servidor Team Foundation.

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.

Ejemplos

El ejemplo siguiente crea en Team Foundation Server un nuevo conjunto de cambios aplazados denominado Reflector_BuddyTest, asigna la propiedad al usuario Hans y devuelve todos los elementos del área de trabajo actual a la versión más reciente descargada durante la última operación de get y establece un estado de sólo lectura.

c:\projects> tf shelve Reflector_BuddyTest;Hans /move

El ejemplo siguiente elimina el conjunto de cambios aplazados existente, un nueva función del servidor, crea un nuevo conjunto de cambios aplazados con ese nombre y conserva todos los cambios pendientes del área de trabajo actual.

c:\projects> tf shelve new-feature /replace

El ejemplo siguiente crea un conjunto de cambios aplazados denominado HelloWorld_TestMe que incluye todos los cambios pendientes en todos los archivos .cs de la carpeta de trabajo C:\projects y sus subcarpetas.

c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive

El ejemplo siguiente elimina el conjunto de cambios aplazados HelloWorld_24.

c:\projects> tf shelve HelloWorld_24 /delete

Vea también

Compartir a través de

Comando shelve

Parámetros

Comentarios

Ejemplos

Vea también

Tareas

Conceptos

Referencia

Otros recursos

Recursos adicionales