Branch (Comando)
El comando branch copia un elemento o conjunto de elementos, incluidos los metadatos y el historial de control de versiones, de una ubicación en otra del servidor de control de versiones de Team Foundation y en el área de trabajo local.
Nota
Los resultados de este comando no se reflejarán 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 Proteger los cambios pendientes.
Permisos necesarios
Para usar el comando branch, el permiso Leer del elemento de origen y los permisos Desproteger y Combinar de la carpeta de destino deben estar establecidos en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.
tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]]
Parámetros
Argumento |
Descripción |
---|---|
olditem |
Especifica el nombre de la carpeta o archivo de código fuente que se bifurca. El parámetro olditem también puede contener información de versión con el formato item;version. |
newitem |
Especifica el nombre del archivo o carpeta de destino o la carpeta primaria de destino. Si newitem ya existe y es una carpeta del servidor control de versiones de Team Foundation, Team Foundation creará los elementos bifurcados en él. De lo contrario, newitem especifica el nombre del archivo o carpeta de destino. Pueden producirse conflictos durante la protección si el destino ya existe. |
versionspec |
Proporciona un valor para la opción /version. Para obtener más información acerca de cómo Team Foundation analiza una especificación de versión para determinar qué elementos se encuentran en su ámbito, vea Sintaxis de la línea de comandos (Control de versiones). |
comment |
Proporciona un comentario sobre la bifurcación. |
@commentfile |
Especifica la ruta de acceso de un archivo que contiene el comentario utilizado para la bifurcación. |
authorname |
Valor proporcionado por el usuario para la opción /author. |
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 |
---|---|
/version |
Versión del elemento en que desea crear la bifurcación. Puede especificar una versión por:
Si no se proporciona ninguna versión, Team Foundation utiliza la lógica siguiente para decidir la versión del elemento que se copiará en la nueva bifurcación:
Si bifurca un archivo cuya versión de área de trabajo es anterior a la última versión que se encuentra en el servidor control de versiones de Team Foundation, el archivo se bifurca en la versión más antigua. |
/lock |
Impide que otros usuarios puedan proteger o desproteger elementos hasta que proteja la bifurcación pendiente y los cambios asociados. Para obtener más información, vea Introducción a los tipos de bloqueo. Opciones de bloqueo:
|
/noget |
Si se especifica esta opción, las copias locales de los archivos y carpetas de la nueva bifurcación no se crean en el área de trabajo local. Sin embargo, las copias locales se recuperarán en el área de trabajo la siguiente vez que se realice una operación de obtención recursiva.
Nota
Puede impedir que los elementos, por ejemplo el contenido de una carpeta /images, se recuperen en el área de trabajo durante operaciones recursivas de obtención y obtención de la última versión escondiendo una carpeta del área de trabajo.Para obtener más información, vea Workfold (Comando).
|
/noprompt |
Suprime todos los mensajes de solicitud de datos. |
/silent |
Implica /noget y especifica que el resultado no se escribe en la ventana del símbolo del sistema al crear una bifurcación. |
/checkin |
Crea y protege la bifurcación al servidor en una operación. Esta opción no crea ningún cambio pendiente en el área de trabajo local. |
/comment |
Agrega un comentario a la nueva bifurcación. Esta opción solo se utiliza con la opción /checkin. |
/author |
Identifica el autor de la nueva bifurcación. Esta opción solo se utiliza con la opción /checkin. |
Comentarios
Si especifica una ruta de acceso local, como c:\00101, pero no especifica versionspec, Team Foundation se basa en la versión de área de trabajo local para crear la nueva bifurcación.
Sin embargo, si especifica una ruta de acceso de servidor como $/00101/*.cs y no especifica versionspec, Team Foundation utiliza en su lugar la última versión del servidor de control de versiones de Team Foundation como base para crear la nueva bifurcación.
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
En el ejemplo siguiente se crea un archivo de bifurcación que contiene la última versión de área de trabajo de 314.cs, se le asigna el nombre "314_branch" y, a continuación, se guarda en el directorio actual en el disco, así como en la carpeta del servidor control de versiones de Team Foundation a la que corresponde.
c:\projects>tf branch 314.cs 314_branch
En el ejemplo siguiente se copian todos los archivos sin cambios pendientes de la versión de área de trabajo de 314.cs de la carpeta del servidor de control de versiones de Team Foundation actual en la carpeta testdata del servidor de control de versiones de Team Foundation y del directorio actual en disco en la carpeta de trabajo correspondiente a la carpeta testdata del servidor de control de versiones de Team Foundation.
c:\projects>tf branch C:\314.cs $/testdata
En el ejemplo siguiente se copian todos los archivos sin cambios pendientes de la versión de área de trabajo actual de la carpeta testfiles y los archivos que contiene de la carpeta del servidor de control de versiones de Team Foundation actual en la carpeta testfiles_branch del servidor de control de versiones de Team Foundation y de c:\testfiles en la carpeta local correspondiente a la carpeta testfiles_branch del servidor de control de versiones de Team Foundation.
c:\projects>tf branch C:\testfiles $/testfiles_branch
En el ejemplo siguiente se crea una bifurcación de 314.cs tal como estaba en el conjunto de cambios nº 4 del archivo. En la carpeta de trabajo en disco y en el servidor control de versiones de Team Foundation, se crea un archivo de bifurcación denominado csharp_branch.
c:\projects>tf branch C:\314.cs;C4 csharp_branch
En el siguiente ejemplo se crea una nueva bifurcación de 314.cs como si fuera el 12/12/03. En la carpeta de trabajo en disco y en el servidor control de versiones de Team Foundation, se crea un archivo de bifurcación denominado 314_branch.
c:\projects>tf branch 314.cs;D12/12/03 314_branch
El ejemplo siguiente bifurca la versión de 314.cs a la que se aplicó la etiqueta "Beta1", le asigna el nombre "Beta1branch" y la guarda en disco en el directorio actual y en la carpeta del servidor control de versiones de Team Foundation a la que corresponde el directorio actual.
c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch
Vea también
Tareas
Referencia
Conceptos
Trabajar con conjuntos de cambios