Attività Exec
Consente di eseguire il programma o il comando specificato con utilizzando gli argomenti specificati.
Parametri
Nella tabella riportata di seguito sono descritti i parametri dell'attività Exec.
Parametro |
Descrizione |
---|---|
Command |
Parametro String obbligatorio. Comando/comandi da eseguire. Possono essere comandi di sistema, ad esempio attrib, o un file eseguibile, ad esempio program.exe, runprogram.bat o setup.msi. Questo parametro può contenere più righe di comandi. In alternativa, è possibile includere più comandi in un file batch ed eseguirlo tramite questo parametro. |
CustomErrorRegularExpression |
Parametro String facoltativo. Specifica un'espressione regolare utilizzata per individuare le righe di errore nell'output dello strumento. Si tratta di un'espressione utile per gli strumenti tramite i quali viene prodotto output con formattazione insolita. |
CustomWarningRegularExpression |
Parametro String facoltativo. Specifica un'espressione regolare utilizzata per individuare le righe di avviso nell'output dello strumento. Si tratta di un'espressione utile per gli strumenti tramite i quali viene prodotto output con formattazione insolita. |
ExitCode |
Parametro di output di sola lettura Int32 facoltativo. Specifica il codice di uscita fornito dal comando eseguito. |
IgnoreExitCode |
Parametro Boolean facoltativo. Se true, il codice di uscita fornito dal comando eseguito viene ignorato dall'attività. In caso contrario, viene restituito false se il comando eseguito restituisce un codice di uscita diverso da zero. |
IgnoreStandardErrorWarningFormat |
Parametro Boolean facoltativo. Se false, le righe dell'output che corrispondono al formato di errore/avviso standard vengono selezionate e registrate come errori/avvisi. Se true, disabilitare questo comportamento. |
Outputs |
Parametro di output ITaskItem[] facoltativo. Contiene gli elementi di output dell'elemento. L'attività Exec non imposta questi elementi autonomamente. È invece possibile fornirli come se fossero stati impostati dall'attività, in modo che possano essere utilizzati in una fase successiva del progetto. |
StdErrEncoding |
Parametro di output String facoltativo. Specifica la codifica del flusso di errore standard acquisito per l'attività. Il valore predefinito è la codifica dell'output della console corrente. |
StdOutEncoding |
Parametro di output String facoltativo. Specifica la codifica del flusso di output standard acquisito per l'attività. Il valore predefinito è la codifica dell'output della console corrente. |
WorkingDirectory |
Parametro String facoltativo. Specifica la directory in cui verrà eseguito il comando. |
Note
Questa attività risulta utile se non è disponibile un'attività MSBuild specifica per l'operazione che si desidera eseguire. Tuttavia, tramite l'attività Exec, a differenza di un'attività più specifica, non è possibile raccogliere informazioni di output dallo strumento o dal comando eseguito.
Anziché richiamare direttamente un processo, l'attività Exec chiama cmd.exe.
Oltre ai parametri elencati in questo documento, questa attività eredita i parametri dalla classe ToolTaskExtension, che eredita dalla classe ToolTask. Per un elenco di tali parametri aggiuntivi e le relative descrizioni, vedere Classe di base ToolTaskExtension.
Esempio
Nell'esempio riportato di seguito l'attività Exec viene utilizzata per eseguire un 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>