Freigeben über


Exec-Aufgabe

Aktualisiert: November 2007

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 mit diesem Parameter ausführen.

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.

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.

Timeout

Optionaler Int32-Parameter.

Gibt die Zeit in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert lautet Int.MaxValue. Dieser gibt an, dass kein Timeoutintervall festgelegt ist.

ToolPath

Optionaler String-Parameter.

Gibt den Speicherort an, von dem die Aufgabe die zugrunde liegende ausführbare Datei (cmd.exe) lädt.

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. Wenn Sie statt einer spezifischeren Aufgabe die Exec-Aufgabe verwenden, hat dies den Nachteil, dass keine Ausgabe von dem ausgeführten Tool oder Befehl erfasst werden kann.

Die Exec-Aufgabe ruft cmd.exe auf, anstatt direkt einen Prozess aufzurufen.

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>

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben