Variablen verwenden

In vielen Befehlen können Sie – wie aus DSM bekannt – Variablen verwenden, um das Script flexibel zu halten und dynamisch auf Situationen reagieren zu können. Da die Packaging PowerBench PowerShell Code erzeugt, haben wir uns entschlossen, von der aus DSM bekannten Darstellung von Variablen – nämlich dem Einschließen des Variablennamens in Prozentzeichen – abzuweichen und die aus PowerShell bekannte Schreibweise mit führendem $-Zeichen zu verwenden.

Da in diesem Fall das Ende des Variablennamens nicht eindeutig ist, schließen wir den Namen in geschweiften Klammern ein.

Um Variablen zu verwenden, geben Sie daher in einem beliebigen Feld eines der Befehls-Dialoge das $-Zeichen ein, woraufhin eine Dropdown-Liste mit den bekannten Variablen angezeigt wird. Wenn Sie nun weiter schreiben, werden Ihnen die zur Eingabe passenden Variablen vorgeschlagen, die Sie dann mit TAB, ENTER oder Klicken mit der Maus übernehmen können. Um Ihnen die Eingabe zu vereinfachen, können Sie beim Tippen auf die öffnende geschwungene Klammer verzichten und mit dem ersten Zeichen des Variablennames fortfahren, die PPB erkennt an dem $-Zeichen, dass Sie eine Variable verwenden möchten und ergänzt die Klammer automatisch.

Hinweis: Sie können die Darstellung von Variablen in der PPB ändern, indem Sie in der Konfigurationsdatei "PackagingPowerBench.exe.config" der PPB im Eintrag "ParameterInputTextMode" einen der folgenden Werte eingeben: "PowerShell", "NiVariable", "SimplePowerShell" (dies ist der Standardwert), "SimpleDollarOnly".


Beginnend mit Version 3.0 der Packaging PowerBench stehen Ihnen weitere Variablen zur Verfügung, die durch einen Variablenprovider ermittelt und dem System bekannt gemacht werden. Prinzipiell ist dieser Provider erweiterbar, sodass Sie auch eigene Standardvariablen definieren können, wenn Sie dies benötigen. Die verfügbaren Variablen beziehungsweise ihre Werte werden durch PowerShell-Scripts, die sich im Unterverzeichnis Variables des Common Runtime Files-Verzeichnisses befinden, deklariert. Die folgenden vier Scripts sind hier standardmäßig vorhanden:

  • ADS.Variables.ps1
    Definiert Active Directory Variablen - diese haben in der PPB das Präfix ADS
  • CurrentPackage.Variables.ps1
    Definiert Variablen das aktuelle Paket betreffend - diese haben in der PPB das Präfix CurrentPackage
  • Misc.Variables.ps1
    Definiert verschiedene Variablen
  • ShellFolders.Variables.ps1
    Definiert Shell Folder Variablen - diese haben in der PPB das Präfix ShellFolders

Bei Bedarf können Sie hier weitere, eigene Scripts hinterlegen, die Variablen deklarieren, und die Sie dann in Ihren Scripts verwenden können. Es wird empfohlen, für eigene Scripts das Namenspräfix "Custom." zu verwenden. Der Name muss auf "Variables.ps1" enden. Ein gültiger, sinnvoller Name wäre daher beispielsweise "Custom.Solys.Variables.ps1". 

Eine Liste der verfügbaren Variablen finden Sie im Anhang im Abschnitt Verfügbare Variablen.