Start, commande (Team Foundation Build)
Utilisez la commande start pour exécuter une définition de build de Team Foundation Build configurée.
Autorisations requises
Pour utiliser la commande start, vos autorisations de sécurité Mettre les builds en file d'attente et Afficher la définition de build dans Visual Studio Team Foundation Server doivent être définies sur 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.
TFSBuild start /collection:teamProjectCollectionUrl
/builddefinition:definitionSpec [/droplocation:droplocation] [/getoption:getoption]
[/customgetversion:versionSpec] [/priority:priority] [/requestedfor:userName]
[/msbuildarguments:args] [/shelveset:shelvesetName [/checkin]]
[/silent] [/queue]
TFSBuild start teamProjectCollectionUrl teamProject definitionName
[/droplocation:droplocation] [/getoption:getoption] [priority:priority]
[/customgetversion:versionSpec] [/requestedfor:userName]
[/shelveset:shelvesetName [/checkin]]
[/msbuildarguments:args] [/silent] [/queue]
Paramètres
Argument |
Description |
|---|---|
teamProjectCollectionUrl |
URL de la collection des projets d'équipe qui contient les solutions et les projets en cours de construction. |
teamProject |
Nom du projet d'équipe qui contient les solutions et projets qui sont construits. |
definitionName |
Nom de la définition de build dans le projet d'équipe que vous souhaitez utiliser pour la génération. |
droplocation |
Chemin d'accès au dossier public où les fichiers journaux et les fichiers binaires de la build sont stockés une fois la génération terminée. Par exemple, \\serveur\partage. Utilisé avec l'option /droplocation. |
getoption |
Utilisé avec l'option /getoption. Les valeurs valides sont LatestOnQueue, LatestOnBuild et Custom. |
versionSpec |
|
priority |
Priorité de file d'attente à utiliser pour la définition de build. Vous pouvez utiliser cet argument avec l'option /priority. Les valeurs valides sont Low, BelowNormal, Normal, AboveNormal et High. |
userName |
Nom de l'utilisateur que vous souhaitez associer à la build terminée. |
args |
Arguments de ligne de commande à passer à MSBuild. |
shelvesetName |
Spécifiez le nom d'un jeu de réservations si vous souhaitez démarrer une génération privée ou démarrer une génération définie avec le déclencheur d'archivage contrôlé. |
Option |
Description |
|---|---|
/collection |
Spécifie la collection du projet d'équipe. |
/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é. .gif "Remarque") Remarque
Lors de la sélection du répertoire de build, assurez-vous que l'espace est suffisant pour la build, car un espace insuffisant entraînerait l'annulation de builds.
|
/getoption |
Facultatif. Spécifie les fichiers que vous souhaitez obtenir du contrôle de version. |
/customgetversion |
Facultatif. Spécifie la version personnalisée des fichiers que vous souhaitez obtenir si vous affectez à /getoption la valeur Personnalisé. |
/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" |
/shelveset |
Facultatif. Spécifiez le nom d'un jeu de réservations si vous souhaitez démarrer une génération privée ou démarrer une génération définie avec le déclencheur d'archivage contrôlé. |
/checkin |
Facultatif. Cette option s'applique uniquement si vous démarrez une build définie avec le déclencheur d'archivage contrôlé. Spécifiez cette option si vous souhaitez que le système archive les fichiers si la génération est réussie. |
/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 demande de démarrage de build dans la file d'attente de build et rend le contrôle 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, tenez compte des dépendances d'une solution vis-à-vis d'une autre lorsque vous déterminez l'ordre dans lequel elles sont 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 crée le type de build Nightlies qui est dans le projet d'équipe AdventureWorks du projet d'équipe à l'adresse http://myserver:8080/DefaultCollection. La build qui en résulte se trouve dans le répertoire BuildDrop.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
L'exemple suivant crée le type de build Nightlies qui est dans le projet d'équipe AdventureWorks de la collection à l'adresse http://myserver:8080/DefaultCollection. 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://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"
Voir aussi
Tâches
Créer une définition de build de base
Autres ressources
Commandes de Team Foundation Build