Get (Tarea)

Actualización: noviembre 2007

La tarea Get recupera una copia de sólo lectura de los archivos y carpetas de un área de trabajo utilizando las opciones especificadas.

Parámetros

Parámetro

Descripción

BuildUri

Especifica el identificador URI de la compilación.

Workspace

Especifica el nombre del área de trabajo.

Version

Especifica el archivo versionspec. De forma predeterminada, el parámetro versionspec utilizado es T o la última versión. Establezca la propiedad GetVersion en el archivo TFSBuild.proj para obtener una versión diferente. Este comportamiento corresponde a la opción /version del comando tf.exe get. Para obtener más información, vea Comando get.

Filespec

Especifica los elementos del área de trabajo. De forma predeterminada, Team Foundation Build obtiene todos los elementos del área de trabajo especificada por la propiedad WorkspaceName. Invalide la propiedad GetFileSpec en el archivo TFSBuild.proj para especificar un parámetro Itemspecconcreto. Este comportamiento corresponde al parámetro Itemspec del comando tf.exe get.

PopulateOutput

De forma predeterminada, Team Foundation Build no devuelve la lista de elementos que se recuperaron, reemplazaron o eliminaron, ni devuelve las advertencias generadas por la tarea Get. Establezca la propiedad GetPopulateOutput en trueen el archivo TFSBuld.proj para hacer que estas listas estén disponibles. Al establecer GetPopulateOutput en true, esto es lo que obtiene:

  • Los elementos recuperados de un grupo de elementos denominado Gets

  • Los elementos reemplazados de un grupo de elementos denominado Replaces

  • Los elementos eliminados de un grupo de elementos denominado Deletes

  • Las advertencias de un grupo de elementos denominado GetWarnings

Preview

Especifica si se muestra o no lo que ocurriría sin realizar realmente la operación Get. Establezca PreviewGet en true en el archivo TFSBuild.proj para obtener una vista previa de la operación Get. Este comportamiento corresponde a la opción /preview del comando tf.exe get.

Recursive

Especifica si se recuperan los archivos de forma recursiva. Establezca la propiedad RecursiveGet en false en el archivo TfsBuild.proj para realizar una tarea de obtención no recursiva en un proyecto de Team Foundation Build. Este comportamiento corresponde a la opción /recursive del comando tf.exe get.

Force

Especifica si los archivos se recuperan de forma incremental. Para realizar una tarea de obtención incremental en una definición de Team Foundation Build, establezca la propiedad ForceGet en false en el archivo TfsBuild.proj. Este comportamiento corresponde a la opción /force del comando tf.exe get.

Gets

Parámetro de salida. Especifica la lista de elementos que recuperó la tarea Get.

Replaces

Parámetro de salida. Especifica la lista de elementos que reemplazó la tarea Get.

Deletes

Parámetro de salida. Especifica la lista de elementos que eliminó la tarea Get.

Warnings

Parámetro de salida. Especifica la lista de advertencias que generó la tarea Get.

Comentarios

La tarea Get se define en Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll. El archivo Microsoft.TeamFoundation.Build.targets contiene una instancia de la tarea Get que Team Foundation Build utiliza como implementación predeterminada del destino CoreGet.

La carpeta <raíz>:\Archivos de programa\MSBuild\Microsoft\VisualStudio\TeamBuild en el equipo de Team Foundation Build contiene el archivo Microsoft.TeamFoundation.Build.targets.

Ejemplo

El ejemplo siguiente muestra la instancia predeterminada de la tarea Get definida en el archivo Microsoft.TeamFoundation.Build.targets.

<Get 
    BuildUri="$(BuildURI)"
    Workspace="$(WorkspaceName)"
    Version="$(GetVersion)"
    Filespec="$(GetFilespec)"
    PopulateOutput="$(GetPopulateOutput)" 
    Preview="$(PreviewGet)"
    Recursive="$(RecursiveGet)"
    Force="$(ForceGet)">
  <Output TaskParameter="Gets" ItemName="Gets" />
  <Output TaskParameter="Replaces" ItemName="Replaces" />
  <Output TaskParameter="Deletes" ItemName="Deletes" />
  <Output TaskParameter="Warnings" ItemName="GetWarnings" />
</Get>

Vea también

Tareas

Cómo: Personalizar números de versión de compilación

Conceptos

Tareas de Team Foundation Build

Referencia

Comando get

Otros recursos

Personalizar Team Foundation Build

Propiedades, tareas y destinos de Team Foundation Build