Compartir a través de

Comando rename (Control de versiones de Team Foundation)

  • Artículo

Actualización: noviembre 2007

El comando rename cambia el nombre o la ruta de acceso de un archivo o carpeta. Puede utilizar 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 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 utilizar el comando rename, el permiso Desproteger debe estar establecido en Permitir. Para obtener más información, consulte Permisos de Team Foundation Server.

tf rename [/lock:(none|checkout|checkin)] olditem newitem

Parámetros

Argumento

Descripción

olditem

Nombre y ruta de acceso original 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 de servidor Control de versiones de Team Foundation como $/myfiles/314.cs.

newitem

Nuevo nombre del archivo o carpeta. Puede utilizar esta opción para especificar un valor local diferente o una ubicación de ruta de acceso del servidor Control de versiones de Team Foundation.

Opción

Descripción

/lock

Incluya esta opción para impedir que otros usuarios puedan proteger o desproteger los elementos especificados. Si no se especifica esta opción, no se cambia el estado de bloqueo existente del elemento. Para obtener más información, vea Introducción a los tipos de bloqueo.

Opciones de bloqueo:

  • Ninguno   No se aplica ningún bloqueo.

  • 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 algunos de los elementos especificados, la operación de bloqueo produce 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.

Comentarios

Utilice el comando rename de la utilidad de línea de comandos tf para mover o cambiar el nombre de un elemento con control de versiones en su área de trabajo. Utilice el comando rename para mover varios archivos especificando caracteres comodín. Sólo se puede cambiar el nombre de varios archivos o carpetas con control de versiones desde la línea de comandos.

Utilice Rename para realizar las siguientes operaciones:

  • Cambiar el nombre de olditemanewitem, como tf rename 314.cs 315.cs.

  • Mover olditem a una nueva ubicación en el servidor de Control de versiones de Team Foundation proporcionando un newitem cuya ruta de acceso sea diferente a la de olditem, como ** **tf rename 314.cs ..\newdir\314.cs.

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

No puede cambiar el nombre de un elemento si:

  • Ya lo ha eliminado antes de que se protegiera en la misma área de trabajo.

  • El nuevo nombre ya existe en el servidor Control de versiones de Team Foundation y no es una carpeta.

  • Ya ha agregado, bifurcado o cambiado el nombre de la protección pendiente del elemento.

  • El elemento está asignado al área de trabajo pero no está disponible en el disco local.

  • El elemento está escondido.

Puede cambiar el nombre de un elemento si se ha agregado otro archivo del mismo nombre con la protección pendiente, pero no puede cambiar el nombre de un elemento que se ha bifurcado y aún no se ha protegido. Cuando cambia el nombre de un archivo con ediciones pendientes, éstas se conservan.

Un elemento asignado explícitamente no se puede cambiar de nombre sin cambiar primero la asignación. Por ejemplo, si hay una asignación de carpeta de trabajo de $/ProyectoX/MiAplic a c:\MiAplic, no puede cambiar el nombre de MiAplic. Puede cambiar el nombre de los elementos incluidos bajo MiAplic, pero no la propia carpeta MiAplic.

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

El ejemplo siguiente cambia el nombre de 314.c por 1254.c.

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

El ejemplo siguiente cambia el nombre de 314.c por 1254.c y lo mueve a la carpeta newdir.

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

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

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

Vea también

Tareas

Cómo: Mover, cambiar de nombre y eliminar archivos y carpetas bajo control de versiones

Conceptos

Introducción a los tipos de bloqueo

Cambios pendientes

Referencia

Sintaxis de la línea de comandos (Team System)

Comando add

Comando Delete (Control de versiones de Team Foundation)

Comando get

Otros recursos

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