Get (Comando)
Recupera una copia de solo lectura de un archivo del servidor de control de versiones de Team Foundation en el área de trabajo y crea las carpetas en disco que lo contendrán.
Permisos necesarios
Para utilizar el comando get, debe tener el permiso Leer establecido en Permitir para cada elemento recuperado, y debe ser el propietario del área de trabajo de destino o disponer del permiso global Administrar áreas de trabajo. Para obtener más información, vea Permisos de Team Foundation Server.
tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force]
[/preview] [/recursive] [/remap] [/noprompt] [/login:username,[password]]
Parámetros
Argumento |
Descripción |
|---|---|
Itemspec |
Archivo o carpeta que se va a recuperar. Si no se proporciona itemspec, Team Foundation Server realiza una operación Get recursiva en todos los elementos que están asignados en el área de trabajo actual. .gif "Nota") Nota
Puede especificar más de un argumento Itemspec.
|
Versionspec |
Valor proporcionado por el usuario para la opción /version. Para obtener más información acerca de cómo Team Foundation Server analiza una especificación de versión para determinar qué elementos se encuentran en su ámbito, vea Sintaxis de la línea de comandos (Control de versiones). |
username |
Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario. |
Opción |
Descripción |
|---|---|
/version |
Especificación de la versión opcional. versionspec es la versión del elemento que desea recuperar. Puede especificar una versión por:
|
/all |
Obliga a recuperar todos los archivos, no solo aquellos que están anticuados. |
/overwrite |
Sobrescribe los archivos editables que no estén desprotegidos. |
/force |
Combina /all y /overwrite. |
/preview |
Muestra lo que ocurriría sin realizar realmente la operación Get. |
/recursive |
Recupera de forma recursiva todos los elementos que coinciden con itemspec. |
/noprompt |
Suprime los cuadros de diálogo que, de lo contrario, se mostrarían durante esta operación. |
/remap |
Actualiza la asignación local en el servidor y vuelve a descargar el archivo más rápidamente si ya ha descargado el mismo archivo de otra bifurcación. Nota
Esta opción es más adecuada si no tiene una asignación local compleja y debe cambiar con frecuencia entre las bifurcaciones.
|
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Team Foundation Server. |
Comentarios
El comando get recupera los elementos del servidor en un área de trabajo. Si no se proporciona ninguna versión, se recupera la última versión del servidor.
Si trabaja en un entorno de desarrollo en equipo, get es el comando que más usará porque al obtener cada uno de los archivos de un proyecto se mantiene sincronizado con el equipo y se asegura de disponer de la copia más reciente del trabajo compartido. El comando get no sobrescribe los archivos que están desprotegidos en el directorio local. Cuanta mayor sea la frecuencia con la que realiza el comando get en un entorno de trabajo colaborativo, más actuales serán los archivos locales con los de su equipo. Eso es porque una operación get rellena el área de trabajo local con cambios protegidos en el servidor por sus compañeros. Si mantiene actualizada el área de trabajo realizando una operación get cada vez que ve una notificación de protección (por ejemplo, alertas de proyecto), puede resolver rápidamente las diferencias entre su versión de un proyecto y la versión del proyecto que hay en el servidor. Puede evitar hacer cambios que no sean fáciles de reconciliar con el servidor al proteger los cambios pendientes.
Durante una operación get , si la versión del área de trabajo es la misma que la versión solicitada del servidor, Team Foundation Server no reemplaza el archivo del disco salvo que esté especificada la opción /all. Puede utilizar la opción /overwrite para sobrescribir por la fuerza la versión del área de trabajo actual grabable con una versión de servidor especificada para restaurar el área de trabajo a un estado coherente cuando se vuelve inmanejable, como ocurre a veces al eliminar o sobrescribir accidentalmente varios archivos en disco. Al pasar la opción /force, Team Foundation Server sobrescribe todos los elementos desprotegidos en el área de trabajo con la versión de servidor más reciente a menos que proporcione una versión concreta.
Al realizar una operación get, Team Foundation Server elimina del servidor todos los archivos protegidos del área de trabajo local que se hayan eliminado desde la última vez que se sincronizó el área de trabajo con la versión del servidor. Los archivos que se han cambiado de nombre o se han movido en el servidor se reubican en disco para que coincidan con los cambios efectuados en el servidor.
Puede utilizar la opción /preview para enviar el comando get sin realizar actualizaciones en el área de trabajo local para ver lo que sucedería si tuviera que ejecutar una operación Get real.
La operación de desprotección no obtiene la última versión de los archivos que se desprotegen.
Si trabaja como desarrollador en un área de trabajo, permanecerá aislado de los cambios realizados por otros desarrolladores. Puede controlar cuándo acepta cambios de otros desarrolladores realizando una operación Get según corresponda. Lo ideal sería actualizar la configuración completa de los archivos controlados por versión y no solo uno o dos archivos porque los cambios realizados en un archivo normalmente dependen de los cambios correspondientes en los demás archivos. Debe asegurarse de que tiene una instantánea coherente de los archivos controlados por versión que se puede compilar y probar.
Por consiguiente, la operación de desprotección no obtiene la última versión de los archivos desprotegidos. La actualización de un archivo que se está desprotegiendo infringiría la instantánea coherente y podría ofrecerle una configuración de los archivos controlados por versión que no se puede generar o probar. Alternativamente Team Foundation Server le obliga a que obtenga la última versión en algún punto antes de la protección de sus cambios para que al intentar proteger los cambios, y no tiene la copia última, se pide confirmación con el cuadro de diálogo de resolución de conflictos.
También puede configurar Team Foundation Server para obtener automáticamente la última versión en la desprotección. Para obtener más información, vea Establecer la configuración de desprotección.
Para obtener más información sobre cómo buscar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.
El proceso Get
Cuando se ejecuta un comando get para un elemento del servidor que ya está desprotegido en el área de trabajo y la versión en el servidor ha cambiado, se le pide que resuelva los conflictos de archivo entre la versión del área de trabajo y la versión en el servidor recuperada. Para obtener más información, vea Comando resolve.
Ejemplos
El ejemplo siguiente recupera la última versión de 314.cs del servidor. Si tiene cambios pendientes en 314.cs, Team Foundation Server iniciará el proceso de resolución que ayuda a decidir cómo administrar los conflictos.
C:\projects>tf get 314.cs
El ejemplo siguiente recupera la versión 8 de 1256.cs del servidor.
Nota
Utilizar 1256.cs;8 es equivalente a utilizar 1256.cs;C8. De forma predeterminada, se utiliza la versión del conjunto de cambios si especifica solo un número después del punto y coma.
C:\>tf get 1256.cs;8
El ejemplo siguiente recupera las versiones más recientes de todos los elementos no ocultos de la carpeta y las subcarpetas del servidor en el directorio C:\projects y crea carpetas locales donde se necesiten. Para obtener más información sobre cómo esconder y mostrar carpetas, vea Workfold (Comando).
C:\projects>tf get
Los ejemplos siguientes proporcionan maneras alternativas de recuperar la versión de 1256.cs que se protegió con el conjunto de cambios 1999.
c:\projects>tf get /version:C1999 1256.cs
— o bien —
c:\projects>tf get 1256.cs;C1999
El ejemplo siguiente recupera la versión de todos los elementos no escondidos del servidor tal como existían en el servidor cuando se creó el conjunto de cambios 271.
c:\projects>tf get /version:C271
El ejemplo siguiente recupera build42, que tiene la etiqueta "build42". Esto compara su área de trabajo con la etiqueta, siempre que no haya ningún cambio pendiente. Los archivos que no estén en la etiqueta se quitan del disco local.
c:\projects>tf get /version:Lbuild42
En el ejemplo siguiente se recupera la versión del servidor correspondiente a una fecha y hora concretas.
c:\projects>tf get /version:D2008-01-21T16:00
Vea también
Tareas
Obtener el código fuente para el proyecto de equipo
Esconder y mostrar carpetas en un área de trabajo