Get, tâche
Mise à jour : novembre 2007
La tâche Get récupère une copie en lecture seule des fichiers et des dossiers contenus dans un espace de travail en utilisant des options spécifiées.
Paramètres
Paramètre |
Description |
|---|---|
BuildUri |
Spécifie l'URI de build. |
Workspace |
Spécifie le nom de l'espace de travail. |
Version |
Spécifie le paramètre versionspec du fichier. Par défaut, versionspec utilisé est T ou la version la plus récente. Définissez la propriété GetVersion dans fichier TFSBuild.proj pour obtenir une version différente. Ce comportement correspond à l'option /version de la commande tf.exe get. Pour plus d'informations, consultez Get, commande. |
Filespec |
Spécifie les éléments de l'espace de travail. Par défaut, Team Foundation Build récupère tous les éléments de l'espace de travail spécifié par la propriété WorkspaceName. Substituez la propriété GetFileSpec dans le fichier TFSBuild.proj pour spécifier un Itemspec spécifique. Cela correspond au paramètre Itemspec de la commande tf.exe get. |
PopulateOutput |
Par défaut, Team Foundation Build ne retourne pas la liste des éléments récupérés, remplacés ou supprimés, ni les avertissements de retour générés par la tâche Get. Attribuez à la propriété GetPopulateOutput la valeur true dans fichier TFSBuild.proj pour rendre ces listes disponibles. Lorsque vous attribuez à GetPopulateOutput la valeur true, vous obtenez ceci :
|
Preview |
Spécifie s'il faut afficher ce qui se produirait sans exécuter réellement l'opération Get. Attribuez à PreviewGet la valeur true dans fichier TFSBuild.proj pour prévisualiser l'opération Get. Cela correspond à l'option /preview de la commande tf.exe get. |
Recursive |
Spécifie si les fichiers sont récupérés de manière récursive. Affectez à la propriété RecursiveGet la valeur false dans le fichier TfsBuild.proj pour exécuter une commande get non récursive dans un projet Team Foundation Build. Cela correspond à l'option /recursive de la commande tf.exe get. |
Force |
Spécifie si les fichiers sont récupérés de façon incrémentielle. Pour exécuter une commande get incrémentielle dans une définition Team Foundation Build, affectez à la propriété ForceGet la valeur false dans le fichier TfsBuild.proj. Cela correspond à l'option /force de la commande tf.exe get. |
Gets |
Paramètre de sortie. Spécifie la liste des éléments récupérés par la tâche Get. |
Replaces |
Paramètre de sortie. Spécifie la liste des éléments remplacés par la tâche Get. |
Deletes |
Paramètre de sortie. Spécifie la liste des éléments supprimés par la tâche Get. |
Warnings |
Paramètre de sortie. Spécifie la liste des avertissements générés par la tâche Get. |
Notes
La tâche Get est définie dans le fichier Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll. Ce fichier contient une instance de la tâche Get que Team Foundation Build utilise comme implémentation par défaut pour la cible CoreGet.
Le dossier <racine>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild sur l'ordinateur Team Foundation Build contient le fichier Microsoft.TeamFoundation.Build.targets.
Exemple
L'exemple suivant affiche l'instance par défaut de la tâche Get définie dans le fichier 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>
Voir aussi
Tâches
Comment : personnaliser des numéros de build
Concepts
Tâches de Team Foundation Build