Comando RENAME

El comando rename cambia el nombre o la ruta de acceso de un archivo o carpeta. Puede utilizar el comando rename o el alias move para mover un archivo o carpeta a una nueva ubicació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 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. Si existe algún bloqueo en el archivo especificado, 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 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 controlado por código fuente 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 bajo control de código fuente desde la línea de comandos.
Utilice Rename para realizar las siguientes operaciones:
• Cambiar el nombre de olditema newitem, como tf rename 314.cs 315.cs.
• Mover olditem a una nueva ubicación en el servidor de Control de código fuente 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 código fuente Team Foundation y no es una carpeta.
• Ya ha agregado, bifurcado o cambiado el nombre del elemento con la protección pendiente.
• 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. Si cambia el nombre de un archivo para el que se ha registrado un cambio de nombre pendiente, el cambio de nombre inicial se reemplaza por el segundo.
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.
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
El ejemplo siguiente cambia el nombre de Form1.vb por MainPage.vb y conserva ese nombre como $/VBApplications/Project2/MainPage.vb) para que otros usuarios no puedan crear un archivo denominado MainPage.vb en la misma ubicación antes de que se protejan los cambios o se libere el bloqueo.
c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin
Seguridad
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.