Comando branch

  • Artículo

Actualización: noviembre 2007

El comando branch copia un elemento o conjunto de elementos, que incluye 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 del á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 Cómo: Proteger cambios pendientes.

Permisos necesarios

Para usar el comando branch, el permiso Lectura del elemento de origen y el permiso Desproteger de la carpeta de destino deben estar establecidos en Permitir. Para obtener más información, consulte Permisos de Team Foundation Server.

tf branch olditem newitem [/version:versionspec] [/noget] [/lock:none|checkin|checkout] [/checkin] [/noprompt]

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 (Team System).

Opción

Descripción

/version

Versión del elemento en que desea crear la bifurcación. Puede especificar una versión por:

  • Fecha y hora (D10/20/2005)

  • Número de conjunto de cambios (C1256)

  • Etiqueta (Lmylabel)

  • Última versión (T)

  • Área de trabajo (Wworkspacename)

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 se especifica una ruta de acceso del servidor Control de versiones de Team Foundation, Team Foundation bifurca el elemento en la última versión del servidor Control de versiones de Team Foundation. Por ejemplo, tf branch $/projects/help.cs utiliza la versión de servidor.

  • Si se especifica una ruta de acceso local para el origen, Team Foundation utiliza la versión de área de trabajo local para crear la nueva bifurcación. Por ejemplo, tf branch C:\314.cs utiliza la versión de área de trabajo local.

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:

  • Ninguno

    Predeterminado. No se aplica ningún bloqueo. Si existe un bloqueo en el archivo para el que va a crear una bifurcación, esta opción lo quita.

  • Checkin

    Otros usuarios pueden desproteger elementos especificados pero no pueden proteger revisiones de archivos bloqueados hasta que se libere el bloqueo realizando una protección. Si otros usuarios han bloqueado alguno de los elementos especificados, la operación de bloqueo producirá un error.

  • Checkout

    Impide que otros usuarios puedan proteger o desproteger cualquiera de los elementos especificados hasta que libere el bloqueo realizando una protección. Si otros usuarios han bloqueado algunos de los elementos especificados, la operación de bloqueo produce un error.

/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 Comando workfold.

/checkin

Únicamente se puede utilizar con la versión de Service Pack 1 de Microsoft Visual Studio Team System 2008 Team Foundation Server.

Protege la acción de bifurcación al mismo tiempo que se crea la bifurcación.

/noprompt

Suprime todos los mensajes de solicitud de datos.

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 encontrar 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

El ejemplo siguiente crea una nueva bifurcación de 314.cs tal como estaba el día 12/12/03. En la carpeta de trabajo 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

Tutorial: Funciones avanzadas del control de versiones

Tutorial: Trabajar con el control de versiones de Team Foundation desde la línea de comandos

Cómo: Bifurcar archivos y carpetas

Conceptos

Introducción a la bifurcación

Trabajar con conjuntos de cambios del control de versiones

Referencia

Comando branches

Comando merge

Otros recursos

Comandos de la utilidad Tf de la línea de comandos