Comando Start (Team Foundation Build)
Aggiornamento: novembre 2007
Utilizzare il comando start per eseguire una definizione di compilazione Team Foundation Build configurata.
Autorizzazioni necessarie
Per utilizzare il comando start, è necessario disporre dell'autorizzazione di sicurezza Avvia compilazione di Team Foundation Server impostata su Consenti. Inoltre, l'account del servizio di livello applicazione e l'account del servizio di Team Foundation Build devono disporre di autorizzazioni di lettura/scrittura per la destinazione finale della compilazione. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
.gif "Nota") Nota: |
|---|
Anche se l'accesso è stato eseguito con le credenziali amministrative, è necessario aprire un prompt dei comandi con privilegi elevati per eseguire questa funzione in un server con Windows Server 2008 in esecuzione. Per aprire un prompt dei comandi con privilegi elevati, fare clic Start, fare clic con il pulsante destro del mouse su Prompt dei comandi e fare clic su Esegui come amministratore. Per ulteriori informazioni, vedere il sito Web Microsoft (informazioni in lingua inglese). |
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]
Parametri
Argomento |
Descrizione |
|---|---|
teamFoundationServer |
URL del server Team Foundation in cui vengono archiviate le soluzioni in corso di compilazione. |
teamProject |
Nome del progetto Team che contiene le soluzioni da compilare. |
definitionName |
Nome della definizione di compilazione nel progetto Team da utilizzare per la compilazione. |
dl |
Percorso alla cartella pubblica dove vengono archiviati i binari delle compilazioni e file di log al termine della compilazione. Ad esempio //server/share. Utilizzato con l'opzione /droplocations. |
go |
Utilizzato con /getoption option.Valid dove i valori sono LatestOnQueue, LatestOnBuild e Custom. |
versionSpec |
Versione di file da compilare quando /getoption è impostato su Custom. Utilizzato con l'opzione /customgetversion. È possibile specificare una versione in base a:
|
p |
Priorità della coda da utilizzare la definizione della compilazione. Utilizzato con l'opzione /priority. I valori validi sono: Low, BelowNormal, Normal, AboveNormal, and High. |
userName |
Utente che richiede la compilazione. |
args |
Argomenti della riga di commando da passare a MSBuild. |
Opzione |
Descrizione |
||
|---|---|---|---|
/droplocation |
Facoltativo. Specifica la directory in cui viene eseguito il processo di compilazione. Può essere abbreviato in /d. Per impostazione predefinita corrisponde alla directory di compilazione specificata nella definizione della compilazione.
|
||
/getoption |
Facoltativo. Specifica i file da ottenere nel controllo della versione. |
||
/customgetversion |
Facoltativo. Specifica la versione personalizzata dei file da ottenere se il valore di /getoption è impostato su Custom. |
||
/priority |
Facoltativo. Specifica la priorità nella coda di compilazione. |
||
/requestedfor |
Facoltativo. Specifica l'utente per il quale è stata richiesta la compilazione. |
||
/msbuildarguments |
Facoltativo. Specifica gli argomenti della riga di comando da passare a MSBuild. Il formato generale è il seguente: /msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget" |
||
/silent |
Facoltativo. Quando si specifica questa opzione, l'output non viene scritto nella finestra del prompt dei comandi durante l'esecuzione della compilazione. |
||
/queue |
Inserisce la richiesta di avvio delle compilazioni nella coda compilazioni e la restituisce immediatamente. |
Note
È possibile utilizzare il comando della riga di comando TFSBuild start di Team Foundation con il servizio Utilità di pianificazione per eseguire compilazione ricorrenti o notturne.
Quando si compilano più soluzioni, determinarne l'ordine di compilazione tenendo conto delle dipendenze tra le soluzioni. Ad esempio, impostare Soluzione 1 in modo che venga compilata prima di Soluzione 2 qualora Soluzione 2 dipenda da Soluzione 1.
La directory di ricezione non viene creata automaticamente per impostazione predefinita come una condivisione. Pertanto non è disponibile per la pubblicazione di compilazioni e risultati di test. È necessario definire manualmente una condivisione, aggiungere autorizzazioni di scrittura per la directory Windows e di condivisione sia per l'account utilizzato per eseguire il servizio Team Build per la creazione di compilazioni nella destinazione finale sia per l'account del tester utilizzato per la pubblicazione dei risultati dei test.
Esempio
Nel seguente esempio viene compilato il tipo di compilazione Nightlies presente nel progetto Team AdventureWorks su server01. Il risultato della compilazione sarà disponibile nella directory BuildDrop.
>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
Nel seguente esempio viene compilato il tipo di compilazione Nightlies presente nel progetto Team AdventureWorks su server01. Il risultato della compilazione sarà disponibile nella directory BuildDrop. Utilizzare l'opzione /msbuildarguments per passare il livello di dettaglio di MSBuild di diagnostica. Per ulteriori informazioni, vedere Riferimenti alla riga di comando di MSBuild.
>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"
Vedere anche
Attività
Procedura: avviare una build dalla riga di comando
Procedura: creare una definizione di compilazione
Altre risorse
Comandi di Team Foundation Build
Esecuzione delle generazioni in Team Foundation Build
Utilizzo delle definizioni di compilazione in Team Foundation Build