Comando Start (Team Foundation Build)
Utilizzare il comando start per eseguire una definizione di compilazione configurata per Team Foundation Build.
Autorizzazioni necessarie
Per utilizzare il comando start, è necessario avere le autorizzazioni di sicurezza Compilazioni in coda e Visualizza definizione di compilazione in Visual Studio Team Foundation Server impostate su Consenti. Inoltre, l'account del servizio di livello applicazione e l'account del servizio di Team Foundation Build devono disporre delle autorizzazioni di lettura/scrittura per la destinazione finale della compilazione. Per ulteriori informazioni, vedere Autorizzazioni per 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]
Parametri
Argomento |
Oggetto di descrizione |
|---|---|
teamProjectCollectionUrl |
URL dell'insieme di progetti team contenente le soluzioni e i progetti in corso di compilazione. |
teamProject |
Nome del progetto team contenente le soluzioni e i progetti in corso di compilazione. |
definitionName |
Nome della definizione di compilazione nel progetto Team che si desidera utilizzare per la compilazione. |
droplocation |
Percorso della cartella pubblica dove vengono archiviati i binari della compilazione e i file di log al termine della compilazione. Ad esempio, //server/share. Utilizzato con l'opzione /droplocation. |
getoption |
Viene utilizzato con l'opzione /getoption. I valori validi sono LatestOnQueue, LatestOnBuild e Custom. |
versionSpec |
|
priority |
Priorità della coda da utilizzare la definizione della compilazione. Utilizzare questo argomento in combinazione con l'opzione /priority. I valori validi sono Low, BelowNormal, Normal, AboveNormal e High. |
userName |
Nome dell'utente che si desidera associare alla compilazione completata. |
args |
Argomenti della riga di commando da passare a MSBuild. |
shelvesetName |
Specificare il nome di un'area di sospensione se si desidera avviare una compilazione privata o se è stata avviata una compilazione definita con il trigger dell'archiviazione gestita. |
Opzione |
Oggetto di descrizione |
|---|---|
/collection |
Specifica l'insieme di progetti team. |
/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. .gif "Nota") Nota
Quando si seleziona la directory di compilazione, assicurarsi che lo spazio disponibile sia sufficiente. Altrimenti il processo di compilazione verrà annullato.
|
/getoption |
Facoltativo. Specifica i file che si desidera ottenere dal controllo della versione. |
/customgetversion |
Facoltativo. Specifica la versione personalizzata dei file che si desidera ottenere impostando il valore di /getoption 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" |
/shelveset |
Facoltativo. Specificare il nome di un'area di sospensione se si desidera avviare una compilazione privata o se è stata avviata una compilazione definita con il trigger dell'archiviazione gestita. |
/checkin |
Facoltativo. Questa opzione si applica solo se si avvia una compilazione definita con il trigger dell'archiviazione gestita. Specificare questa opzione se si desidera che il sistema archivi i file quando la compilazione ha esito positivo. |
/silent |
Facoltativo. Quando si seleziona questa opzione, l'output non verrà scritto nella finestra del prompt dei comandi durante l'esecuzione della compilazione. |
/queue |
Inserisce la richiesta di avvio della compilazione nella coda compilazioni e ritorna 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 esistenti 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. Non è pertanto disponibile per la pubblicazione di compilazioni e risultati di test. È necessario definire manualmente una condivisione, aggiungere autorizzazioni di scrittura per la directory Windows e autorizzazioni di condivisione sia per l'account utilizzato per eseguire il servizio Team Build per il rilascio di build sia per l'account del tester utilizzato per la pubblicazione dei risultati dei test.
Esempio
Nell'esempio seguente viene compilato il tipo di compilazione Nightlies presente nel progetto team AdventureWorks nell'insieme di progetti team all'indirizzo http://myserver:8080/DefaultCollection. Il risultato della compilazione sarà disponibile nella directory BuildDrop.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
Nell'esempio seguente viene compilato il tipo di compilazione Nightlies presente nel progetto team AdventureWorks nell'insieme all'indirizzo http://myserver:8080/DefaultCollection. 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://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"
Vedere anche
Attività
Creare una definizione di compilazione di base
Altre risorse
Comandi di Team Foundation Build