Compartir a través de

Comando Branch (Control de versiones de Team Foundation)

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019

Visual Studio 2019 | de Visual Studio 2022

El comando TFVC branch copia un elemento o un conjunto de elementos, incluidos los metadatos y el historial de control de versiones, desde una ubicación a otra en el servidor de Azure DevOps y en el área de trabajo local.

Nota

Los resultados de este comando no se reflejan en el servidor de Azure DevOps hasta que realice una operación de comprobación. Para obtener más información, consulte Comprobación del trabajo en el código base del equipo.

Prerrequisitos

Para usar el comando , tenga el permiso de lectura para el elemento de origen y los permisos de Desactive y Combinar para la carpeta de destino establecida en Permitir. Para obtener más información, consulte permisos predeterminados de TFVC.

Sintaxis

tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]] [/recursive]

Parámetros

Argumento

de argumentos de descripción
<olditem> Especifica el nombre del archivo de origen o la carpeta que se va a bifurcar. El <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 del destino. Si <*newitem> ya existe y es una carpeta de Azure DevOps Server, TFVC crea los elementos bifurcados dentro de él. De lo contrario, <newitem> especifica el nombre del archivo o carpeta de destino. Los conflictos pueden producirse durante la comprobación si el destino ya existe.
<versionspec> Proporciona un valor para la opción /version. Para obtener más información sobre cómo TFVC analiza una especificación de versión para determinar qué elementos están dentro de su ámbito, consulte Usar comandos de control de versiones de Team Foundation.
<comment> Proporciona un comentario sobre la rama.
@<commentfile> Especifica la ruta de acceso de un archivo que contiene el comentario que se usa para la rama.
<authorname> Valor proporcionado por el usuario para la opción /author.
<username> Proporciona un valor a la opción /login. Puede especificar un valor de nombre de usuario como DOMAIN\username o <username>.

Opción

de opción de

descripción

/version

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

  • Fecha y hora (D10/20/2005)
  • Número del conjunto de cambios (C1256)
  • Etiqueta (Lmylabel)
  • Versión más reciente (T)
  • Workspace (Wworkspacename)

Si no se proporciona ninguna versión, TFVC usa la siguiente lógica para decidir qué versión del elemento se va a copiar en la nueva rama:

  • Si se especifica una ruta de acceso de Azure DevOps Server, TFVC bifurca el elemento en la versión más reciente de Azure DevOps Server. Por ejemplo, tf branch $/projects/help.cs usa la versión del servidor.
  • Si se especifica una ruta de acceso local para el origen, TFVC usa la versión local del área de trabajo para crear la nueva rama. Por ejemplo, tf branch C:\314.cs usa la versión del área de trabajo local.

Si bifurca un archivo cuya versión del área de trabajo es anterior a la versión más reciente en el servidor de Azure DevOps, el archivo se bifurca en la versión anterior.

/lock

Impide que otros usuarios registren o desproteger elementos hasta que se registren en la rama pendiente y los cambios asociados. Para obtener más información, consulte Descripción de los tipos de bloqueo.

Opciones de bloqueo:

  • none
    Predeterminado. No se aplica ningún bloqueo. Si existe un bloqueo en el archivo para el que va a crear una rama, esta opción la quita.
  • checkin
    Otros usuarios pueden consultar los elementos especificados, pero no pueden proteger las revisiones en los archivos bloqueados hasta que libere el bloqueo realizando una comprobación. Si algún otro usuario ha bloqueado alguno de los elementos especificados, se produce un error en la operación de bloqueo.
  • checkout
    Impide que otros usuarios puedan proteger o desproteger cualquiera de los elementos especificados hasta que libere el bloqueo realizando una comprobación. Si algún otro usuario ha bloqueado alguno de los elementos especificados, se produce un error en la operación de bloqueo.

/noget

Si se especifica esta opción, las copias locales de los archivos y carpetas de la nueva rama no se crean en el área de trabajo local. Sin embargo, las copias locales se recuperarán en el área de trabajo la próxima vez que realice una operación get recursiva.

Nota

Puede evitar que los elementos, como el contenido de una carpeta de /images, se recuperen en el área de trabajo durante la obtención recursiva y obtengan las operaciones más recientes ocultando una carpeta del área de trabajo. Para obtener más información, vea Comando workfold.

/noprompt

Suprime las solicitudes de entrada de usted.

/silent

Implica /nogety especifica que la salida no se escribe en la ventana del símbolo del sistema al crear una rama.

/checkin

Crea y comprueba la rama en el 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 rama. Esta opción solo se usa con la opción /checkin.

/author

Identifica el autor de la nueva rama. Esta opción solo se usa con la opción /checkin.

/recursive

En el caso de las carpetas, bifurca todos los archivos dentro también.

Observaciones

Si especifica una ruta de acceso local como c:\00101 pero no especifica una <versionspec>, TFVC usa la versión del área de trabajo local como base para crear la nueva rama.

Sin embargo, si especifica una ruta de acceso de servidor como $/00101/*.cs y no especifica una <versionspec>, TFVC usa la versión más reciente de Azure DevOps Server como base para crear la nueva rama en su lugar.

Para obtener más información sobre cómo usar la utilidad de línea de comandos de tf, consulte Usar comandos de control de versiones de Team Foundation.

Ejemplos

En los ejemplos siguientes se supone que c:\projects se asigna a la carpeta principal del área de trabajo.

En el ejemplo siguiente se crea un archivo de rama que contiene la versión más reciente del área de trabajo de 314.cs, se le asigna 314_branchy se guarda en el directorio actual en el disco y también en la carpeta Azure DevOps Server a la que se asigna.

c:\projects>tf branch 314.cs 314_branch

En el ejemplo siguiente se copian todos los archivos sin modificaciones pendientes en la versión del área de trabajo de 314.cs desde su carpeta actual de Azure DevOps Server en la carpeta testdata Azure DevOps Server y desde el directorio actual del disco a la carpeta de trabajo que se asigna a la carpeta testdata carpeta de Azure DevOps Server.

c:\projects>tf branch C:\314.cs $/testdata

En el ejemplo siguiente se copian todos los archivos sin modificaciones pendientes en la versión actual del área de trabajo de la carpeta testfiles y los archivos que contiene para todos los elementos de su carpeta actual de Azure DevOps Server en la carpeta testfiles_branch Azure DevOps Server y desde c:\testfiles en la carpeta local que se asigna a la carpeta testfiles_branch Azure DevOps Server.

c:\projects>tf branch C:\testfiles $/testfiles_branch

En el ejemplo siguiente se crea una rama de 314.cs tal como existía en el conjunto de cambios n.º 4 para el archivo. En la carpeta de trabajo del disco, como en el servidor de Azure DevOps, se crea un archivo de rama titulado csharp_branch.

c:\projects>tf branch C:\314.cs;C4 csharp_branch

En el ejemplo siguiente se crea una nueva rama de 314.cs tal como estaba el 12/12/03. En la carpeta de trabajo del disco como en el servidor de Azure DevOps, se crea un archivo de rama titulado 314\branch.

c:\projects>tf branch 314.cs;D12/12/03 314_branch

En el ejemplo siguiente se bifurca la versión de 314.cs a la que se aplicó la etiqueta Beta1, se le asigna el nombre Beta1branchy se guarda en el directorio actual del disco, además de la carpeta de Azure DevOps Server a la que se asigna el directorio actual.

c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch