Start, commande (Team Foundation Build)
Mise à jour : novembre 2007
Utilisez la commande start pour exécuter une définition de build Team Foundation Build configurée.
Autorisations requises
Pour utiliser la commande start, l'autorisation de sécurité Démarrer la build de Team Foundation Server doit avoir la valeur Autoriser. En outre, le compte de service de couche Application et le compte de service Team Foundation Build doivent avoir des autorisations de lecture/écriture sur l'emplacement cible de la build. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
.gif "Remarque") Remarque : |
|---|
Même si vous êtes connecté en tant qu'administrateur, vous devez ouvrir une invite de commandes avec autorisations élevées pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une invite de commandes avec autorisations élevées, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Pour plus d'informations, consultez le site Web de Microsoft (en anglais). |
TFSBuild start /server:teamFoundationServer
/builddefinition:definitionSpec [/droplocations:dl] [/getoption:go]
[/customgetversion:versionSpec] [/priority:p] [/requestedfor:userName]
[/msbuildarguments:args] [/silent] [/queue]
TFSBuild start teamFoundationServer teamProject definitionName
[/droplocation:dl] [/getoption:go] [priority:p]
[/customversion:versionSpec] [/requestedfor:userName]
[/msbuildarguments:args] [/silent] [/queue]
Paramètres
Argument |
Description |
|---|---|
teamFoundationServer |
URL du serveur Team Foundation où les solutions en cours de génération sont archivées. |
teamProject |
Nom du projet d'équipe contenant les solutions à générer. |
definitionName |
Nom de la définition de build dans le projet d'équipe à utiliser pour la génération. |
dl |
Chemin d'accès au dossier public où les binaires de génération et les fichiers journaux sont enregistrés une fois la génération terminée. Par exemple, //server/share. Utilisé avec l'option /droplocations. |
go |
Utilisé avec l'option /getoption. Valide où les valeurs sont LatestOnQueue, LatestOnBuild et Custom. |
versionSpec |
Version des fichiers à générer lorsque /getoption a la valeur Custom. Utilisé avec l'option /customgetversion. Vous pouvez spécifier une version par :
|
p |
Priorité de file d'attente à utiliser pour la définition de build. Utilisé avec l'option /priority. Les valeurs valides sont : Low, BelowNormal, Normal, AboveNormal et High. |
userName |
Utilisateur demandant la génération. |
args |
Arguments de ligne de commande à passer à MSBuild. |
Option |
Description |
||
|---|---|---|---|
/droplocation |
Facultatif. Spécifie le répertoire dans lequel le processus de génération se produit. Peut être abrégé en /d. Par défaut, le répertoire de build spécifié dans la définition de build est utilisé.
|
||
/getoption |
Facultatif. Spécifie les fichiers à obtenir du contrôle de version. |
||
/customgetversion |
Facultatif. Spécifie la version personnalisée des fichiers à obtenir si la valeur de /getoption spécifiée est Custom. |
||
/priority |
Facultatif. Spécifie la priorité de file d'attente de build. |
||
/requestedfor |
Facultatif. Spécifie pour qui la génération a été demandée. |
||
/msbuildarguments |
Facultatif. Spécifie les arguments de ligne de commande à passer à MSBuild. Le format général est le suivant : /msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget" |
||
/silent |
Facultatif. Lorsque vous spécifiez cette option, le résultat n'est pas écrit dans la fenêtre Invite de commandes pendant l'exécution de la build. |
||
/queue |
Insère la requête de démarrage de build dans la file d'attente de build et la retourne immédiatement. |
Notes
Vous pouvez utiliser la commande TFSBuild start de Team Foundation avec le service du planificateur de tâches Windows pour exécuter des builds récurrentes ou nocturnes.
Si vous générez plusieurs solutions, envisagez une solution qui a des dépendances avec une autre lorsque vous déterminez l'ordre dans lequel elles seront générées. Par exemple, configurez la Solution1 pour qu'elle soit générée avant la Solution2 si la Solution2 a une dépendance sur la Solution1.
Par défaut, le répertoire de dépôt n'est pas créé automatiquement en tant que partage. Par conséquent, il ne permet pas de publier des builds et des résultats de tests. Vous devez établir un partage manuellement et ajouter des autorisations en écriture au répertoire Windows et des autorisations de partage pour le compte utilisé pour exécuter le service Team Build afin de déplacer des builds et pour le compte du testeur afin de publier des résultats de tests.
Exemple
L'exemple suivant génère le type de build Nightlies qui est dans le projet d'équipe AdventureWorks sur le server01. La build qui en résulte se trouve dans le répertoire BuildDrop.
>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
L'exemple suivant génère le type de build Nightlies qui est dans le projet d'équipe AdventureWorks sur le server01. La build qui en résulte se trouve dans le répertoire BuildDrop. Utilisez l'option /msbuildarguments pour passer dans le niveau de commentaires de diagnostic MSBuild. Pour plus d'informations, consultez Référence de la ligne de commande MSBuild.
>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"
Voir aussi
Tâches
Comment : commencer une build à partir de la ligne de commande
Comment : créer une définition de build
Autres ressources
Commandes de Team Foundation Build
Exécution de builds dans Team Foundation Build
Utilisation de définitions de build dans Team Foundation Build