Befehl "Start" (Team Foundation Build)
Aktualisiert: November 2007
Verwenden Sie den start-Befehl, um eine konfigurierte Team Foundation Build-Builddefinition auszuführen.
Erforderliche Berechtigungen
Für die Verwendung des start-Befehls muss die Build starten-Sicherheitsberechtigung auf dem 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.
.gif "Hinweis") Hinweis: |
|---|
Selbst wenn Sie mit Administratorrechten angemeldet sind, müssen Sie eine erweiterte Eingabeaufforderung öffnen, um diese Funktion auf einem Server auszuführen, auf dem Windows Server 2008 installiert ist. Um eine erweiterte Eingabeaufforderung zu öffnen, klicken Sie auf Start, klicken mit der rechten Maustaste auf Eingabeaufforderung und klicken dann auf Ausführen als Administrator. Weitere Informationen finden Sie auf der Microsoft-Website. |
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]
Parameter
Argument |
Beschreibung |
|---|---|
teamFoundationServer |
Die URL des Team Foundation-Servers, auf dem die zu erstellenden Projektmappen eingecheckt werden. |
teamProject |
Der Teamprojektname der zu erstellenden Projektmappen. |
definitionName |
Der Name der Builddefinition für den Build im Teamprojekt. |
dl |
Pfad des öffentlichen Ordners, in dem die Binär- und Protokolldateien nach Abschluss des Builds gespeichert werden. Zum Beispiel //server/share. Wird mit der /droplocations-Option verwendet. |
go |
Wird mit der /getoption-Option verwendet. Gültig für die Werte LatestOnQueue, LatestOnBuild und Custom. |
versionSpec |
Version von Dateien, die erstellt werden sollen, wenn /getoption auf Custom festgelegt wird. Wird mit der /customgetversion-Option verwendet. Sie können die Version durch Folgendes angeben:
|
p |
Die Priorität für die Builddefinition in der Warteschlange. Wird mit der /priority-Option verwendet. Gültige Werte sind: Low, BelowNormal, Normal, AboveNormal und High. |
userName |
Benutzer, der den Build anfordert. |
args |
Befehlszeilenargumente, die an MSBuild übergeben werden. |
Option |
Beschreibung |
||
|---|---|---|---|
/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.
|
||
/getoption |
Optional. Gibt die Dateien an, die von der Versionskontrolle abgerufen werden. |
||
/customgetversion |
Optional. Gibt die benutzerdefinierte Version der Dateien an, die abgerufen werden, wenn der Wert von /getoption als Custom angegeben wird. |
||
/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" |
||
/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
Im folgenden Beispiel wird der Buildtyp Nightlies erstellt, der sich im Teamprojekt AdventureWorks auf server01 befindet. Der erstellte Build befindet im Verzeichnis BuildDrop.
>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
Im folgenden Beispiel wird der Buildtyp Nightlies erstellt, der sich im Teamprojekt AdventureWorks auf server01 befindet. Der erstellte Build befindet sich 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://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"
Siehe auch
Aufgaben
Gewusst wie: Starten eines Builds von der Befehlszeile aus
Gewusst wie: Erstellen einer Builddefinition