Comando rename (Control de versiones de Team Foundation)

  • Artículo

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

Visual Studio 2019 | Visual Studio 2022

El comando Control de versiones de Team Foundation (TFVC) rename cambia el nombre o la ruta de acceso de un archivo o carpeta. Puede usar el comando rename o los alias move o ren, para mover un archivo o carpeta a una nueva ubicación.

Nota:

Los resultados de este comando no se reflejan en el servidor hasta que realice una inserción en el repositorio. Para más información, vea Desarrollo de código y administración de cambios pendientes.

Requisitos previos

Para usar el comando rename, debe tener el permiso Extraer del repositorio establecido en Permitir. Para más información, vea Permisos predeterminados de TFVC.

Sintaxis

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

Parámetros

Argumentos

Argument

Descripción

<olditem>

Nombre original y ruta de acceso del archivo o carpeta cuyo nombre se va a cambiar. Puede especificar una ruta de acceso del área de trabajo local, como C:\myfiles\314.cs o una ruta de acceso del servidor TFVC, como $/myfiles/314.cs.

<newitem>

Nuevo nombre del archivo o carpeta. Puede usarlo para especificar una ubicación de ruta de acceso del servidor TFVC o local diferente.

<username>

Proporciona un valor a la opción /login. Puede especificar un valor de nombre de usuario como DOMAIN\username o username.

Opciones

Opción

Descripción

/lock

Incluya esta opción para impedir que otros usuarios entren o desprotegan los elementos especificados. Si no se especifica esta opción, no se cambia el estado de bloqueo existente del elemento. Para más información, vea Descripción de los tipos de bloqueo.

Opciones de bloqueo:

  • None: No se aplica ningún bloqueo.
  • Checkin: otros usuarios pueden extraer del repositorio los elementos especificados, pero no pueden insertar en el repositorio las revisiones de archivos bloqueados hasta que libere el bloqueo mediante una inserción en el repositorio. Si cualquier 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 insertar en el repositorio o extraer del repositorio cualquiera de los elementos especificados hasta que libere el bloqueo realizando una inserción en el repositorio. Si cualquier otro usuario ha bloqueado alguno de los elementos especificados, se produce un error en la operación de bloqueo.

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps.

Observaciones

Puede usar el comando rename de la utilidad de línea de comandos tf para mover o cambiar el nombre de un elemento controlado por versiones en el área de trabajo. Use el comando rename para mover varios archivos especificando caracteres comodín. La capacidad de cambiar el nombre de varios archivos o carpetas controlados por versiones solo está disponible desde la línea de comandos.

Use el comando rename para realizar las siguientes acciones:

  • Cambie el nombre del olditem al newitem, como tf rename 314.cs 315.cs.
  • Mueva el olditem a una nueva ubicación en el servidor TFVC proporcionando un newitem cuya ruta de acceso difiere de la del olditem, como tf rename 314.cs ..\newdir\314.cs.

Si proporciona un newitem que especifica una carpeta inexistente, el comando rename crea la carpeta de destino. Si newitem es una carpeta, olditem se convierte en un elemento secundario de newitem.

No se puede cambiar el nombre de un elemento si:

  • Ya lo eliminó antes de que se protegió en la misma área de trabajo.
  • El nuevo nombre ya existe en el servidor TFVC y no es una carpeta.
  • Ya ha agregado, bifurcado o cambiado el nombre de la comprobación pendiente del elemento.
  • El elemento se asigna en el área de trabajo, pero no está disponible en el disco local.
  • El elemento está escondido.

Puede cambiar el nombre de un elemento para el que se ha agregado otro archivo del mismo nombre pendiente, pero no se puede cambiar el nombre de un elemento que se ha bifurcado pero que aún no se ha protegido. Al cambiar el nombre de un archivo que tiene ediciones pendientes, se conservan las modificaciones.

No se puede cambiar el nombre de un elemento asignado explícitamente sin cambiar primero la asignación. Por ejemplo, si hay una asignación de carpetas de trabajo de $/ProjectX/MyApp a c:\MyApp, no puede cambiar el nombre de MyApp. Puede cambiar el nombre de los elementos en MyApp, pero no en MyApp.

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

Ejemplos

En el ejemplo siguiente se cambia el nombre de 314.cs a 1254.cs.

c:\projects>tf rename  314.cs  1254.cs

En el ejemplo siguiente se cambia el nombre de 314.cs a 1254.cs y se mueve a la carpeta newdir.

c:\projects>tf rename 314.cs ..\newdir\1254.cs

En el ejemplo siguiente se cambia el nombre de Form1.vb a MainPage.vb y se aplica un bloqueo a él.

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin