Comando rename (Control de versiones de Team Foundation)
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.
.gif "Nota") 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:
|
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
Referencia
Sintaxis de la línea de comandos (Team System)
Comando Delete (Control de versiones de Team Foundation)