Comando get
Actualización: noviembre 2007
Recupera una copia de solo lectura de un archivo del servidor 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]
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 del área de trabajo actual. |
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 (Team System). |
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. |
/remap |
Únicamente se puede utilizar con la versión de Service Pack 1 de Microsoft Visual Studio Team System 2008 Team Foundation Server. Actualiza las referencias a la base de datos de la bifurcación reasignada local para todos los elementos cuyo contenido en el disco local es igual que el contenido que se está descargando desde la bifurcación de control de versiones. |
/noprompt |
Suprime los cuadros de diálogo que, de lo contrario, se mostrarían durante esta operación. |
Comentarios
El comando get recupera los elementos del servidor en un área de trabajo. Si no se especifica ninguna versión, se recupera la última versión del servidor. Al realizar una operación get, Team Foundation Server elimina del servidor todos los archivos marcados localmente para su eliminación que se hayan protegido desde la última vez que se sincronizó el área de trabajo con el 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. Los archivos que se han cambiado de nombre o se han movido en el servidor también se mueven en el área de trabajo local para que coincidan con los cambios efectuados en el servidor.
El comando get no sobrescribe los archivos que están desprotegidos en el directorio del área de trabajo local. 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 del servidor. Para obtener más información, vea Comando resolve.
Utilice la opción /all si su versión del área de trabajo es igual que la versión de servidor solicitada y desea reemplazar el archivo en disco.
Utilice la opción /overwrite para forzar la sobrescritura de la versión de escritura del área de trabajo actual con una versión de servidor especificada.
Utilice la opción /force para sobrescribir todos los elementos desprotegidos en el área de trabajo con la última versión del servidor. También puede utilizar la opción /force para sobrescribir una versión concreta.
Utilice la opción /preview para ver qué cambios se producirán durante la próxima operación get.
.gif "Nota") Nota: |
|---|
Utilice con frecuencia el comando get para mantener el área de trabajo actualizada y resolver con rapidez las diferencias entre las versiones del proyecto local y del servidor. |
Para obtener 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.
Utilizar Get con la opción /remap
La opción /remap ahorra tiempo de descarga al reasignar una carpeta local a una bifurcación nueva o diferente. Por ejemplo:
Se asigna $/branch1 a D:\branch en el equipo.
Se ejecuta tf get para obtener una copia de todos los elementos de $/branch1 en la carpeta local.
Se cambia la asignación de $/branch1 y, a continuación, se asigna $/branch2 a la carpeta local asignada previamente como $/branch1 (D:\branch).
Se ejecuta tf get con la opción /remap para descargar únicamente el contenido de $/branch2 que sea distinto del contenido de $/branch1 en la carpeta local (D:\branch).
| Nota: |
|---|
Esta característica solo está disponible si ha instalado la versión de Service Pack 1 de Microsoft Visual Studio Team System 2008 Team Foundation Server. |
Ejemplos
El ejemplo siguiente recupera la última versión de 314.cs del servidor. Si tiene cambios pendientes para 314.cs, Team Foundation Server solicita que se resuelvan los conflictos que pueda haber.
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 Comando workfold.
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
Tutorial: Trabajar con el control de versiones de Team Foundation desde la línea de comandos
Cómo: Obtener el código fuente para el proyecto de equipo
Cómo: Esconder y mostrar carpetas en un área de trabajo