Exec 工作
使用指定的引數執行指定的程式或命令。
參數
下表說明 Exec 工作的參數。
參數 |
描述 |
|---|---|
Command |
必要的 String 參數。 要執行的命令。 這些命令可能是系統命令 (例如 attrib) 或可執行檔 (例如 program.exe、runprogram.bat 或 setup.msi)。 這個參數可以包含多行命令。 或者，您也可以將多個命令放在批次檔中，並使用這個參數來執行它。 |
CustomErrorRegularExpression |
選擇性 String 參數。 指定要在工具輸出中找出錯誤行的規則運算式。 這對產生非一般格式輸出的工具非常有用。 |
CustomWarningRegularExpression |
選擇性 String 參數。 指定要在工具輸出中找出警告行的規則運算式。 這對產生非一般格式輸出的工具非常有用。 |
ExitCode |
選擇性 (Optional) Int32 輸出唯讀參數。 指定由執行的命令所提供的結束代碼 (Exit Code)。 |
IgnoreExitCode |
選擇性 Boolean 參數。 如果為 true，則工作會忽略由執行的命令所提供的結束代碼。 否則，如果執行的命令傳回非零的結束代碼，工作便會傳回 false。 |
IgnoreStandardErrorWarningFormat |
選擇性 Boolean 參數。 如果為 false，則選取輸出中符合標準錯誤/警告格式的文字行，並將其記錄為錯誤/警告。 如果為 true，則停用此行為。 |
Outputs |
選擇性的 ITaskItem[] 輸出參數。 含有工作的輸出項目。 Exec 工作不會自行設定這些項目。 反之，您可以提供這些項目，就像是工作設定過這些項目一樣，以便以後能在專案中加以使用。 |
StdErrEncoding |
選擇性 String 輸出參數。 指定擷取之工作標準錯誤資料流的編碼方式。 預設是目前主控台輸出的編碼方式。 |
StdOutEncoding |
選擇性 String 輸出參數。 指定擷取之工作標準輸出資料流的編碼方式。 預設是目前主控台輸出的編碼方式。 |
WorkingDirectory |
選擇性 String 參數。 指定將會執行命令的目錄。 |
備註
當無法使用您所執行的工作 (Job) 之特定 MSBuild 工作 (Task) 時，這項工作 (Task) 便相當有用。 但是與較特殊的工作不同，Exec 工作無法從其所執行的工具或命令收集輸出。
Exec 工作會呼叫 cmd.exe，而不會直接叫用程序。
除了本文件中列出的參數之外，此項工作還會繼承 ToolTaskExtension 類別中的參數，而該類別本身又繼承 ToolTask 類別。 如需這些錯誤碼的清單及其說明，請參閱 ToolTaskExtension 基底類別。
範例
下列範例使用 Exec 工作來執行命令。
<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>