Befehl "Start" (Team Foundation Build)
Verwenden Sie den start-Befehl, um eine konfigurierte Builddefinition für Team Foundation Build auszuführen.
Erforderliche Berechtigungen
Zum Verwenden des start-Befehls müssen Ihre Sicherheitsberechtigungen Warteschlangenbuilds und Builddefinition anzeigen in Visual Studio Team Foundation Server auf Zulassen festgelegt sein. Zusätzlich werden für das Dienstkonto auf Anwendungsebene und das Team Foundation Build-Dienstkonto Lese-/Schreibberechtigungen für den Ablagespeicherort des Builds benötigt. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
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]
Parameter
Argument |
Beschreibungen |
|---|---|
teamProjectCollectionUrl |
URL der Teamprojektauflistung, die die zu erstellenden Projektmappen und Projekte enthält. |
teamProject |
Name des Teamprojekts, das die zu erstellenden Projektmappen und Projekte enthält. |
definitionName |
Der Name der Builddefinition im Teamprojekt, das für den Build verwendet werden soll. |
droplocation |
Pfad des öffentlichen Ordners, in dem die Binär- und Protokolldateien des Builds nach Abschluss des Builds gespeichert werden. Zum Beispiel "\\server\share". Wird mit der /droplocation-Option verwendet. |
getoption |
Wird mit der Option /getoption verwendet. Gültige Werte sind "LatestOnQueue", "LatestOnBuild" und "Custom". |
versionSpec |
|
priority |
Die Priorität für die Builddefinition in der Warteschlange. Sie verwenden dieses Argument zusammen mit der /priority-Option. Gültige Werte sind Low, BelowNormal, Normal, AboveNormal und High. |
userName |
Name des Benutzers, den Sie dem abgeschlossenen Build zuordnen möchten. |
args |
Befehlszeilenargumente, die an MSBuild übergeben werden. |
shelvesetName |
Geben Sie den Namen eines Shelvesets an, wenn Sie einen privaten Build starten möchten oder einen Build starten, der mit dem abgegrenzten Einchecktrigger definiert wird. |
Option |
Beschreibungen |
|---|---|
/collection |
Gibt die Teamprojektsammlung an. |
/droplocation |
Optional. Gibt das Verzeichnis an, in dem der Buildprozess ausgeführt wird. Dieses kann mit /d abgekürzt werden. Standardmäßig wird das in der Builddefinition festgelegte Buildverzeichnis verwendet. .gif "Hinweis") Hinweis
Stellen Sie beim Auswählen des Buildverzeichnisses sicher, dass genügend Speicherplatz für den Build vorhanden ist. Unzureichender Speicherplatz führt zum Abbruch des Builds.
|
/getoption |
Optional. Gibt die Dateien an, die Sie von der Versionskontrolle abrufen möchten. |
/customgetversion |
Optional. Gibt die benutzerdefinierte Version der Dateien an, die abgerufen werden sollen, wenn Sie den Wert von /getoption als "Benutzerdefiniert" angeben. |
/priority |
Optional. Gibt die Priorität in der Buildwarteschlange an. |
/requestedfor |
Optional. Gibt an, für wen der Build angefordert wurde. |
/msbuildarguments |
Optional. Gibt Befehlszeilenargumente an, die an MSBuild übergeben werden. Das allgemeine Format ist: /msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget" |
/shelveset |
Optional. Geben Sie den Namen eines Shelvesets an, wenn Sie einen privaten Build starten möchten oder einen Build starten, der mit dem abgegrenzten Einchecktrigger definiert wird. |
/checkin |
Optional. Diese Option ist nur gültig, wenn Sie einen Build starten, der mit dem abgegrenzten Einchecktrigger definiert wird. Geben Sie diese Option an, wenn das System Dateien einchecken soll, wenn die Erstellung erfolgreich ist. |
/silent |
Optional. Wenn Sie diese Option angeben, wird die Ausgabe während dem Ausführen des Builds nicht im Eingabeaufforderungsfenster angezeigt. |
/queue |
Fügt die Startanforderung des Builds in die Buildwarteschlange ein und kehrt sofort zurück. |
Hinweise
Mithilfe des Team Foundation-Befehlszeilenbefehls TFSBuild start und dem Taskplanerdienst können wiederkehrende oder nächtliche Buildvorgänge durchgeführt werden.
Wenn Sie mehr als eine Projektmappe erstellen, beachten Sie beim Festlegen der Buildreihenfolge, dass zwischen den Projektmappen Abhängigkeiten bestehen können. Legen Sie beispielsweise fest, dass Projektmappe 1 vor Projektmappe 2 erstellt wird, wenn Projektmappe 2 eine Abhängigkeit mit Projektmappe 1 aufweist.
Standardmäßig wird das Ablageverzeichnis nicht automatisch freigegeben. Deshalb kann es nicht zum Veröffentlichen von Builds und Testergebnissen verwendet werden. Sie müssen manuell eine Freigabe erstellen und Schreibberechtigungen zum Windows-Verzeichnis hinzufügen sowie Freigabeberechtigungen sowohl für das Konto, unter dem der Team Build-Dienst zum Ablegen der Builds ausgeführt wird, als auch für das Testkonto hinzufügen, damit die Testergebnisse veröffentlicht werden können.
Beispiel
Das folgende Beispiel erstellt den Buildtyp Nightlies, der sich im AdventureWorks-Teamprojekt in der Teamprojektauflistung unter http://myserver:8080/DefaultCollection befindet. Der erstellte Build befindet im Verzeichnis BuildDrop.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
Das folgende Beispiel erstellt den Buildtyp Nightlies, der sich im AdventureWorks-Teamprojekt in der Auflistung unter http://myserver:8080/DefaultCollection befindet. Der erstellte Build befindet im Verzeichnis BuildDrop. Verwenden Sie die /msbuildarguments-Option zur Übergabe des MSBuild-Ausführlichkeitsgrads zur Diagnose. Weitere Informationen finden Sie unter MSBuild-Befehlszeilenreferenz.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"
Siehe auch
Aufgaben
Erstellen einer einfachen Builddefinition