Iniciar o comando (Team Foundation Build)
Use o start comando para executar uma definição de compilação configurado para Team Foundation Build.
Permissões necessárias
Para usar o start de comando, você deve ter o compilações de fila e definição de compilação do modo de exibição permissões de segurança no Visual Studio Team Foundation Server definido como Permitir. Além disso, a conta de serviço de camada de aplicativo e o conta de serviço deTeam Foundation Build deve ter permissões de leitura/gravação para o local de destino de compilação. Para obter mais informações, consulte Permissões de 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]
Parâmetros
Argument |
Description |
|---|---|
teamProjectCollectionUrl |
URL da coleção de projeto de equipe que contém as soluções e projetos que estão sendo criados. |
teamProject |
Nome do projeto da equipe que contém as soluções e projetos que está sendo criados. |
definitionName |
Nome da definição de compilação no projeto de equipe que você deseja usar para a compilação. |
droplocation |
O caminho para a pasta pública onde estão armazenados os binários e arquivos de log de compilação após a compilação é concluído. Por exemplo, \\servidor\compartilhamento. Isso é usado com o /droplocation opção. |
getoption |
Usado com o /getoption opção. Os valores válidos são LatestOnQueue, LatestOnBuild e personalizada. |
versionSpec |
|
priority |
Prioridade de fila para a definição de compilação. Você usar esse argumento com o /priority opção. Os valores válidos são de baixo, abaixo do normal, Normal, AboveNormal e alta. |
userName |
Nome do usuário que você deseja associar a compilação concluída. |
args |
Argumentos de linha de comando para passar para MSBuild. |
shelvesetName |
Especifique o nome de um shelveset, se você deseja iniciar uma compilação particular ou estiver iniciando uma compilação que é definida com o disparador gated check-in. |
Option |
Description |
|---|---|
/collection |
Especifica a coleção de projeto de equipe. |
/droplocation |
Optional. Especifica o diretório onde ocorre o processo de compilação. Pode ser abreviada como /d. Por padrão, o diretório de compilação especificado na definição da compilação é usado. .gif "Observação") Observação
Quando você seleciona o diretório de compilação, certifique-se de que o espaço de compilação é suficiente porque o espaço insuficiente levará para compilações canceladas.
|
/getoption |
Optional. Especifica os arquivos que você deseja obter do controle de versão. |
/customgetversion |
Optional. Especifica a versão personalizada de arquivos que você deseja obter, se você especificar o valor de /getoption como personalizado. |
/priority |
Optional. Especifica a prioridade de fila de compilação. |
/requestedfor |
Optional. Especifica para quem a compilação foi solicitada. |
/msbuildarguments |
Optional. Especifica os argumentos de linha de comando para passar para MSBuild. O formato geral é: /msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget" |
/shelveset |
Optional. Especifique o nome de um shelveset, se você deseja iniciar uma compilação particular ou estiver iniciando uma compilação que é definida com o disparador gated check-in. |
/checkin |
Optional. Esta opção se aplica somente se estiver iniciando uma compilação que é definida com o disparador gated check-in. Especifique esta opção se desejar que o sistema para verificar arquivos, se a compilação seja bem-sucedida. |
/silent |
Optional. Quando você especificar esta opção, a saída não é gravada na janela do Prompt de comando quando a compilação estiver em execução. |
/queue |
Insere a solicitação de início da compilação na fila de compilação e retorna imediatamente. |
Comentários
Você pode usar o Team Foundation linha de comando TFSBuild start com o serviço Agendador de tarefas para executar compilações noturnas ou recorrente.
Se você criar mais de uma solução, considere uma solução para ter dependências em outra, ao determinar a ordem em que são criados. Por exemplo, defina o Solution1 deve ser criada antes da solução no caso onde a solução tem uma dependência no Solution1.
Por padrão, o diretório de recebimento não é automaticamente criado como um compartilhamento. Portanto, não está disponível para publicação de compilações e resultados de teste. Manualmente, você deve estabelecer um compartilhamento e adicionar permissões de gravação para o diretório do Windows e permissões de compartilhamento para a conta usada para executar o Team Build serviço para descartar as compilações e para a conta do testador para publicação de resultados de teste.
Exemplo
O exemplo a seguir cria um tipo de compilação as compilações noturnas está no projeto de equipe AdventureWorks na coleção de projeto de equipe em http://myserver:8080/DefaultCollection. A compilação resultante está localizada no diretório BuildDrop.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
O exemplo a seguir cria um tipo de compilação as compilações noturnas está no projeto de equipe AdventureWorks na coleção em http://myserver:8080/DefaultCollection. A compilação resultante está no diretório BuildDrop. Use o /msbuildarguments opção passar a MSBuild o nível de verbosidade de diagnóstico. For more information, see Referência de linha de comando do MSBuild.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"
Consulte também
Tarefas
Criar uma definição de compilação básico
Outros recursos
Equipe Foundation Compilar Comandos de