Comando rename (Control de versiones de Team Foundation)
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
alnewitem
, comotf rename 314.cs 315.cs
. - Mueva el
olditem
a una nueva ubicación en el servidor TFVC proporcionando unnewitem
cuya ruta de acceso difiere de la delolditem
, comotf 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
Artículos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte:Enviar e ver os comentarios