Freigeben über


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

  • Versionsspezifikation, die die Dateien angibt, die erstellt werden sollen, wenn /getoption auf "Benutzerdefiniert" festgelegt wird. Sie können diesen Befehl zusammen mit der /customgetversion-Option verwenden. Weitere Informationen zur versionspec-Syntax finden Sie unter Befehlszeilensyntax (Versionskontrolle).

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.

HinweisHinweis
   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

Weitere Ressourcen

Team Foundation Build-Befehle

Ausführen und Überwachen von Builds

Definieren des Buildprozesses