Exec-Aufgabe
Führt das angegebene Programm oder den angegebenen Befehl mit den angegebenen Argumenten aus.
Parameter
In der folgenden Tabelle werden die Parameter für die Exec-Aufgabe beschrieben.
Parameter |
Beschreibung |
|---|---|
Command |
Erforderlicher String-Parameter. Die auszuführenden Befehle. Diese können Systembefehle sein, z. B. attrib, oder eine ausführbare Datei, z. B. program.exe, runprogram.bat oder setup.msi. Dieser Parameter kann mehrere Zeilen mit Befehlen enthalten. Alternativ können Sie mehrere Befehle in eine Batchdatei einfügen und die Datei mit diesem Parameter ausführen. |
CustomErrorRegularExpression |
Optionaler String-Parameter. Gibt einen regulären Ausdruck an, mit dem Fehlerzeilen in der Ausgabe des Tools bestimmt werden. Dies ist nützlich für Tools, die eine außergewöhnlich formatierte Ausgabe erzeugen. |
CustomWarningRegularExpression |
Optionaler String-Parameter. Gibt einen regulären Ausdruck an, mit dem Warnungszeilen in der Ausgabe des Tools bestimmt werden. Dies ist nützlich für Tools, die eine außergewöhnlich formatierte Ausgabe erzeugen. |
ExitCode |
Optionaler schreibgeschützter Int32-Ausgabeparameter. Gibt den vom ausgeführten Befehl bereitgestellten Exitcode an. |
IgnoreExitCode |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, ignoriert die Aufgabe den vom ausgeführten Befehl bereitgestellten Exitcode. Andernfalls gibt die Aufgabe false zurück, wenn der ausgeführte Befehl einen Exitcode ungleich 0 (null) zurückgibt. |
IgnoreStandardErrorWarningFormat |
Optionaler Boolean-Parameter. Wenn false, werden Zeilen in der Ausgabe ausgewählt, die dem Standard-Fehler-/Warnungsformat entsprechen, und als Fehler/Warnungen protokolliert. Wenn true, dieses Verhalten deaktivieren. |
Outputs |
Optionaler ITaskItem[]-Ausgabeparameter. Enthält die Ausgabeelemente der Aufgabe. Die Exec-Aufgabe legt diese nicht selbst fest. Sie können die Ausgabeelemente so bereitstellen, als ob sie von der Aufgabe festgelegt würden, sodass sie zu einem späteren Zeitpunkt im Projekt verwendet werden können. |
StdErrEncoding |
Optionaler String-Ausgabeparameter. Gibt die Codierung des aufgezeichneten Standardfehlerstreams der Aufgabe an. Standardmäßig wird ist die aktuelle Konsolenausgabecodierung verwendet. |
StdOutEncoding |
Optionaler String-Ausgabeparameter. Gibt die Codierung des aufgezeichneten Standardausgabestreams der Aufgabe an. Standardmäßig wird ist die aktuelle Konsolenausgabecodierung verwendet. |
WorkingDirectory |
Optionaler String-Parameter. Gibt das Verzeichnis an, in dem der Befehl ausgeführt wird. |
Hinweise
Diese Aufgabe ist nützlich, wenn eine bestimmte MSBuild-Aufgabe für den Auftrag, den Sie ausführen möchten, nicht verfügbar ist. Jedoch kann die Exec-Aufgabe, im Gegensatz zu einer spezifischeren Aufgabe, nicht die Ausgabe von dem Tool oder dem Befehl sammeln, das oder der sie ausgeführt.
Die Exec-Aufgabe ruft cmd.exe auf, anstatt direkt einen Prozess aufzurufen.
Zusätzlich zu den in diesem Dokument aufgeführten Parametern erbt diese Aufgabe Parameter von der ToolTaskExtension-Klasse, die selbst von der ToolTask-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter ToolTaskExtension-Basisklasse.
Beispiel
Im folgenden Beispiel wird die Exec-Aufgabe verwendet, um einen Befehl auszuführen.
<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>