Shelve (Comando)

Artículo
08/10/2011

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

Permisos necesarios

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

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

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.
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.
username	Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario.
TeamProjectCollectionUrl	La dirección URL de la colección de proyectos de equipo que contiene los archivos o carpetas que desea aplazar (por ejemplo, http://myserver:8080/tfs/DefaultCollection/).

Opción	Descripción
/move	Quita los cambios pendientes del área de trabajo después de que la operación de aplazamiento se lleva a cabo.
/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.
/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 de validación está activada, el cuadro de diálogo evaluará las directivas de protección y comprobará que se han rellenado las notas de protección necesarias. Esta opción es útil cuando se envían los cambios para su revisión y protección por otra persona.
/login	Especifica el nombre de usuario y la contraseña para autenticar al usuario con Team Foundation Server.
/collection	Especifica la colección del proyecto de equipo.

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 Unshelve (Comando).

Si incluye la opción /move, el comando shelve revierte 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 característica 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

Shelve (Comando)

Parámetros

Comentarios

Ejemplos

Vea también

Tareas

Referencia

Conceptos

Otros recursos

Recursos adicionales