Condividi tramite


Attività Get

Aggiornamento: novembre 2007

L'attività Get consente di recuperare una copia in sola lettura dei file e delle cartelle in un'area di lavoro utilizzando opzioni specificate.

Parametri

Parametro

Descrizione

BuildUri

Specifica l’URI di compilazione.

Workspace

Specifica il nome dell'area di lavoro.

Version

Specifica il file versionspec. Per impostazione predefinita il parametro versionspec utilizzato è T, oppure la versione più recente. Impostare la proprietà GetVersion all’interno del file TFSBuild.proj per ottenere una versione differente. Corrisponde all’opzione /version del comando tf.exe get Per ulteriori informazioni, vedere Comando Get.

Filespec

Specifica gli elementi nell'area di lavoro. Per impostazione predefinita, Team Foundation Build recupera tutti gli elementi nell'area di lavoro specificata dalla proprietà WorkspaceName. Eseguire l'override della proprietà GetFileSpec nel file TFSBuild.proj per indicare uno specifico Itemspec. Corrisponde al parametro Itemspec del comando tf.exe get

PopulateOutput

Per impostazione predefinita, Team Foundation Build non restituisce l'elenco degli oggetti che sono stati recuperati, sostituiti o eliminati, né restituisce gli avvisi generati dall'attività Get. Impostare la proprietà GetPopulateOutput su truenel file TFSBuld.proj per rendere disponibili tali elenchi. Quando si impostano GetPopulateOutput su true, il risultato ottenuto è:

  • Elementi recuperati in un gruppo di elementi denominato Gets

  • Elementi sostituiti in un gruppo di elementi denominato Replaces

  • Elementi eliminati in un gruppo di elementi denominato Deletes

  • Avvisi in un gruppo di elementi denominato GetWarnings

Preview

Indica se visualizzare ciò che si sarebbe verificato senza l'esecuzione dell'operazione Get. Impostare PreviewGet su true nel file TFSBuild.proj per visualizzare in anteprima l'operazione Get. Corrisponde al parametro /preview del comando tf.exe get

Recursive

Specifica se i file vengono recuperati in modo ricorsivo. Impostare la proprietà RecursiveGet su false nel file TfsBuild.proj per eseguire il recupero in modo non ricorsivo in un progetto Team Foundation Build. Corrisponde al parametro /recursive del comando tf.exe get

Force

Specifica se i file vengono recuperati in modo incrementale. Per eseguire un recupero incrementale in una definizione Team Foundation Build, impostare la proprietà ForceGet a false nel file TfsBuild.proj. Corrisponde all’opzione /force del comando tf.exe get

Gets

Parametro di output Specifica la lista degli elementi che sono stati recuperati dall'attività Get.

Replaces

Parametro di output Specifica la lista degli elementi che sono stati sostituiti dall'attività Get.

Deletes

Parametro di output Specifica la lista degli elementi che sono stati eliminati dall'attività Get.

Warnings

Parametro di output Specifica la lista degli avvisi generati dall'attività Get

Note

L'attività Get è definita nel file Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll. Il file Microsoft.TeamFoundation.Build.targets contiene un'istanza dell'attività Get utilizzata da Team Foundation Build come implementazione predefinita per la destinazione CoreGet.

La cartella <radice>:\Programmi\MSBuild\Microsoft\VisualStudio\v8.0\TeamBuild nel computer Team Foundation Build contiene il file Microsoft TeamFoundation Build targets.

Esempio

Nel seguente esempio viene illustrata l'istanza predefinita dell'attività Get definita nel file 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>

Vedere anche

Attività

Procedura: personalizzare numeri di generazione

Concetti

Attività di Team Foundation Build

Riferimenti

Comando Get

Altre risorse

Personalizzazione di Team Foundation Build

Destinazioni, attività e proprietà di Team Foundation Build