SetEnv-Aufgabe
Hinweis
Diese Aufgabe ist nur verfügbar, wenn Sie das C++-Buildsystem verwenden.
Legt den Wert einer bestimmten Umgebungsvariable fest oder löscht ihn.
Parameter
In der folgenden Tabelle werden die Parameter der SetEnv-Aufgabe beschrieben.
Parameter | Beschreibung |
---|---|
Name | Erforderlicher String-Parameter. Der Name einer Umgebungsvariablen. |
OutputEnvironmentVariable | Optionaler String-Ausgabeparameter. Enthält den Wert, der der Umgebungsvariablen zugewiesen ist, die durch den Parameter Name angegeben wird. |
Präfix | Erforderlicher Boolean -Parameter.Wenn true , wird der Wert des Value-Parameters vor dem Wert der Umgebungsvariablen verkettet, die durch den Name-Parameter angegeben wird. Anschließend wird der Umgebungsvariable das Ergebnis zugewiesen. Wenn false , wird der Umgebungsvariablen nur der Wert des Value-Parameters zugewiesen. |
Ziel | Optionaler String -Parameter. Gibt den Ort an, an dem eine Umgebungsvariable gespeichert wird. Geben Sie „User“ oder „Machine“ an. Weitere Informationen finden Sie unter EnvironmentVariableTarget-Enumeration. |
Wert | Optionaler String -Parameter. Der Wert, der der Umgebungsvariablen zugewiesen ist, die durch den Parameter Name angegeben wird. Die Variable wird gelöscht wenn Value leer und die Variable vorhanden ist. Wenn die Variable vorhanden ist, tritt kein Fehler auf, obwohl der Vorgang nicht ausgeführt werden kann. Weitere Informationen finden Sie unter Environment::SetEnvironmentVariable-Methode. |