Comando add
Actualización: noviembre 2007
Agrega nuevos archivos y carpetas de una ubicación del sistema de archivos local a un servidor Control de versiones de Team Foundation.
.gif "Nota") Nota: |
|---|
Los resultados de este comando no se reflejan en el servidor Control de versiones de Team Foundation hasta que realice una operación de protección. Para obtener más información, vea Cómo: Proteger cambios pendientes. |
Permisos necesarios
Para utilizar el comando add, debe ser el propietario del área de trabajo y debe tener establecido en Permitir el permiso Desproteger para la carpeta primaria de los nuevos elementos. También debe tener el permiso Bloquear establecido en Permitir si se usa /lock:checkout o /lock:checkin. Para obtener más información, vea Permisos de Team Foundation Server.
tf add itemspec [/lock:none|checkin|checkout] [/type:filetype]
[/noprompt] [/recursive]
Parámetros
Argumento |
Descripción |
|---|---|
itemspec |
Identifica los archivos o carpetas que se van a agregar. Para obtener más información acerca de cómo Team Foundation analiza itemspecs para determinar qué elementos están dentro del ámbito, vea Sintaxis de la línea de comandos (Team System). |
filetype |
Se utiliza con la opción /type. Para obtener más información, vea Tipos de archivo. |
Opción |
Descripción |
|---|---|
/type |
Reemplaza la coincidencia de tipo de archivo y agrega los archivos al servidor de Control de versiones de Team Foundation que utiliza el tipo especificado. Para obtener más información, vea Tipos de archivo. La detección del tipo de archivo se basa en el contenido del primer kilobyte del archivo. |
/lock |
Especifica un tipo de bloqueo o quita un bloqueo de un elemento. Opciones de bloqueo:
|
/noprompt |
Suprime todos los mensajes de solicitud de datos. |
/recursive |
Agrega todos los elementos al directorio especificado y sus subdirectorios. |
Comentarios
Para agregar un elemento al control de versiones, debe configurar un área de trabajo local y establecer las asignaciones de la carpeta de trabajo. Para obtener más información acerca de cómo empezar, vea Tutorial: Trabajar con el control de versiones de Team Foundation desde la línea de comandos.
Add es un comando de Cambios pendientes; programa los elementos que especifique para agregarlos al servidor Control de versiones de Team Foundation después de finalizar una operación de protección en el área de trabajo. Para ejecutar un comando de cambio pendiente, el directorio actual debe estar asignado a un área de trabajo y al servidor Control de versiones de Team Foundation a los que corresponde.
Cuando se utiliza el comando Add para agregar un nuevo elemento al control de versiones fuente, el elemento no se agrega realmente al servidor de Control de versiones de Team Foundation hasta que se protegen los cambios más recientes del área de trabajo. En su lugar, el elemento se agrega a la lista de cambios pendientes del área de trabajo actual. Para confirmar la adición pendiente al servidor Control de versiones de Team Foundation, puede proteger directamente el archivo agregado o proteger todos los cambios pendientes en el área de trabajo local. Si le preocupa que otro usuario pueda agregar un archivo o carpeta con el mismo nombre que una de sus adiciones pendientes al servidor de Control de versiones de Team Foundation antes de que tenga la oportunidad de proteger los cambios pendientes, incluya la opción /lock con el parámetro Checkout para evitar que esto ocurra. Para obtener más información, vea Cómo: Proteger cambios pendientes.
Si agrega 314.cs al control de versiones mediante tf add /teamproject/projects/math/314.cs, cada una de estas carpetas se considera una adición pendiente si aún no existe, hasta que se protejan los cambios. Cuando proteja los cambios, si alguna de las carpetas de la ruta de acceso especificada (/teamproject, /teamproject/projects o /teamproject/projects/math) ya no existe en el servidor de Control de versiones de Team Foundation, Team Foundation la creará automáticamente.
Utilice el comando Add para establecer la estructura de archivos inicial de un servidor Control de versiones de Team Foundation. Para obtener más información, vea Tutorial: Trabajar con el control de versiones de Team Foundation desde la línea de comandos.
Para obtener más información sobre cómo encontrar 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 agrega los archivos 314.c y 1256.c a la lista de cambios pendientes del área de trabajo a la que está asociada la carpeta de trabajo C:\Pi.
c:\pi>tf add 314.cs 1256.c
El ejemplo siguiente agrega todos los archivos de código C# (.cs) del directorio actual y sus subdirectorios a la lista de adiciones pendientes del área de trabajo actual.
c:\projects>tf add *.cs /recursive
El ejemplo siguiente agrega todos los archivos y carpetas cuyos nombres contienen "hello" en el directorio actual y todas sus subcarpetas a la lista de adiciones pendientes del área de trabajo a la que está asignado c:\projects.
c:\projects>tf add *hello* /recursive
Vea también
Tareas
Tutorial: Trabajar con el control de versiones de Team Foundation desde la línea de comandos
Cómo: Agregar archivos y carpetas que no son de proyecto ni de solución al control de versiones
Cómo: Proteger cambios pendientes
Cómo: Bloquear y desbloquear carpetas o archivos
Conceptos
Introducción a los tipos de bloqueo