Partilhar via


Tarefa Exec

Executa o programa ou comando especificado, usando os argumentos especificados.

Parâmetros

A tabela a seguir descreve os parâmetros para o Exec de tarefas.

Parâmetro

Descrição

Command

Obrigatório String parâmetro.

Comandos para executar. Eles podem ser os comandos do sistema, como, por exemplo, attrib, ou um executável, como, por exemplo, exe, runprogram.bat ou Setup. msi.

Este parâmetro pode conter várias linhas de comandos. Como alternativa, você pode colocar vários comandos em um arquivo em lotes e executá-lo usando esse parâmetro.

CustomErrorRegularExpression

Opcional String parâmetro.

Especifica uma expressão regular que é usada para linhas de erro especial na saída da ferramenta. Isso é útil para as ferramentas de produzem saída formatada incomum.

CustomWarningRegularExpression

Opcional String parâmetro.

Especifica uma expressão regular que é usada para linhas especiais de aviso na saída da ferramenta. Isso é útil para as ferramentas de produzem saída formatada incomum.

ExitCode

Opcional Int32 saída somente leitura parâmetro.

Especifica o código de saída é fornecido pelo comando executado.

IgnoreExitCode

Opcional Boolean parâmetro.

Se true, a tarefa ignora o código de saída que é fornecido pelo comando executado. Caso contrário, a tarefa retorna false se o comando executado retorna um código de saída de diferente de zero.

IgnoreStandardErrorWarningFormat

Opcional Boolean parâmetro.

Se false, seleciona linhas na saída que correspondem ao formato de aviso/erro padrão e registra-los como erros / avisos. Se true, desabilitar esse comportamento.

Outputs

Opcional ITaskItem[] parâmetro de saída.

Contém os itens de saída da tarefa. O Exec tarefa não definido esses próprio. Em vez disso, você pode fornecê-los como se ele definido, para que eles podem ser usados posteriormente no projeto.

StdErrEncoding

Opcional String parâmetro de saída.

Especifica a codificação do fluxo de erro padrão tarefa capturados. O padrão é o atual console codificação de saída.

StdOutEncoding

Opcional String parâmetro de saída.

Especifica a codificação do fluxo de saída padrão tarefa capturados. O padrão é o atual console codificação de saída.

WorkingDirectory

Opcional String parâmetro.

Especifica o diretório no qual o comando será executado.

Comentários

Esta tarefa é útil quando um determinado MSBuild de tarefas para o trabalho que você deseja executar não está disponível. No entanto, o Exec a tarefa, ao contrário de uma tarefa mais específica, não é possível coletar a saída da ferramenta ou comando que ele executa.

O Exec cmd. exe chamadas de tarefas em vez de invocando diretamente de um processo.

Além de para os parâmetros listados neste documento, essa tarefa herda os parâmetros da ToolTaskExtension , a própria classe herda o ToolTask classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base de ToolTaskExtension.

Exemplo

O exemplo a seguir usa a Exec a tarefa para executar um comando.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <Binaries Include="*.dll;*.exe"/>
    </ItemGroup>

    <Target Name="SetACL">
        <!-- set security on binaries-->
        <Exec Command="echo y| cacls %(Binaries.Identity) /G everyone:R"/>
    </Target>

</Project>

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild