Add (Comando)
Agrega archivos y carpetas de una ubicación del sistema de archivos local a un servidor de control de versiones de Team Foundation.
Nota
Los resultados de este comando no se reflejan en el servidor de control de versiones de Team Foundation hasta que realice una operación de protección. Para obtener más información, vea Proteger los cambios pendientes.
Permisos necesarios
Para utilizar el comando add, debe ser el propietario del área de trabajo y su permiso Desproteger de la carpeta primaria de los nuevos elementos debe estar establecido en Permitir. Su permiso Bloquear también debe estar establecido en Permitir si utiliza /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] [/login:username,[password]]
Parámetros
Argumento |
Descripción |
|---|---|
itemspec |
Identifica los archivos que se van a agregar. Para obtener más información acerca de cómo Team Foundation analiza itemspecs para determinar qué elementos se encuentran en ese ámbito, vea Sintaxis de la línea de comandos (Control de versiones). .gif "Nota") Nota
Puede especificar más de un argumento Itemspec.
|
filetype |
Se utiliza con la opción /type. Para obtener más información, vea Administrar tipos de archivo. |
username |
Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como Dominio\NombreDeUsuario o NombreDeUsuario. |
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 Administrar 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. |
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server. |
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.
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 Proteger los 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 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 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
Agregar archivos y carpetas que no son de proyecto ni de solución al control de versiones
Proteger los cambios pendientes
Bloquear y desbloquear carpetas y archivos
Conceptos
Introducción a los tipos de bloqueo