DSM Pakete importieren

Die Packaging PowerBench erlaubt auch den Import von exportierten DSM-Paketen und dabei die Konvertierung in ein PowerShell-Script. Um ein DSM-Paket in der PPB zu importieren gehen Sie daher folgendermaßen vor:

Exportieren Sie das DSM-Paket in der DSM Konsole in ein beliebiges temporäres Verzeichnis.
Wenn Sie die PPB gerade geöffnet haben, klicken Sie auf dem Start-Bildschirm auf "DSM Paket importieren".
Alternativ wählen Sie den Menüpunkt "Importieren" aus dem "Datei"-Menü oder Klicken im "Aufgaben"-Register auf das "DSM Paket importieren" Icon.
Nun erscheint der Dialog für den Import von DSM-Paketen:

Hier müssen Sie im Feld "DSM Paket" die "Script.inc" des exportierten Pakets auswählen oder angeben. Nach der Auswahl wird aus der "_ExpInfo.xml" der Name des DSM Pakets ausgelesen und als Paketname für das PPB-Paket vorgeschlagen. Außerdem schlägt der Dialog einen Speicherort für das Paket vor.
Optional können Sie den Speicherort einer DSM Variablendatei angeben. Diese erzeugen Sie, indem Sie in der Infrastruktur-Ansicht der DSMC den Menüpunkt "Extras > Alle Variablen anzeigen…" auswählen und dann dort über "Exportieren…" die DSM bekannten Variablen samt zugehöriger aktueller Werte in einer CSV Datei speichern. Der Dialog erwartet eine Standard-Exportdatei nach dem Namensschema "_ExpList_AllVariables_*.csv".
Passen Sie Name und Speicherort bei Bedarf an und bestätigen Sie den Import-Dialog mit "OK".

Das Script wird nun analysiert und es wird versucht, möglichst viele Kommandos in die entsprechenden PowerShell-Kommandos zu konvertieren. Ein typisches per NetInstall-Spy erstelltes Paket sieht nach dem Import und der Konvertierung beispielsweise so aus:

Wenn Sie ein DSM-Paket importiert haben, werden Ihnen eventuell einige mit "[Note]:" beginnende Kommentare auffallen, die von umgekehrten, nicht unterstützten oder hinzugefügten Argumenten sprechen. Diese Kommentare sind keine Fehler, sondern sollen Sie informieren, dass im ursprünglichen Script Optionen gesetzt waren, die im Rahmen der Konvertierung geändert wurden oder geändert werden mussten und nennen Ihnen auch kurz den Grund für die Änderung. Sie können die Kommentare, per Multi-Select auswählen und löschen, wenn diese für Sie nicht mehr relevant sind.

Die häufigsten Kommentare sind:

Kommentar	Die Option /TS wird nicht unterstützt und wurde in /TW geändert.
Bedeutung	Die Option /TS steht in DSM für die Befehls-Klassifizierung "Per Service auszuführender Befehl (computerbezogen)". Da die PPB nur zwischen Computerteil und Benutzerteil unterscheidet, werden solche Kommandos in die Klassifizierung "Computerbezogener Befehl" geändert.
Schweregrad	Warnung
Aktion	Bitte prüfen Sie, ob der konvertierte Befehl so funktioniert, wie erwartet.

Kommentar	Command '<Name des eScript Befehls>' is undefined.
Bedeutung	Dieses DSM eScript-Kommando kann (noch) nicht in PowerShell übersetzt werden. Bitte beachten Sie den untenstehenden Hinweis.
Schweregrad	Fehler
Aktion	Sie müssen die Aktion, die der ursprüngliche Befehl ausgeführt hat, selbst implementieren.

Kommentar	The following variables are undefined
Bedeutung	Im Script wurden Variablen gefunden, die nicht konvertiert werden konnten.
Schweregrad	Fehler
Aktion	Sie müssen diese Variablen, die eventuell DSM-interne Variablen waren oder ohne Deklaration verwendet wurden, im PowerShell-Script initialisieren, damit das Script funktioniert.

Hinweis: Wenn ein eScript-Befehl nicht übersetzt werden kann, weil das entsprechende PackageDeployment-Pendant noch nicht implementiert ist, so kommt der Hinweis "[Note]: Command '<betreffendes Kommando>' is undefined.". Sie müssen dann versuchen, die Logik des Scripts zu ändern oder das fehlende Kommando mit PowerShell-Bordmitteln abzubilden. Nehmen Sie bitte auf jeden Fall auch Kontakt mit uns auf (siehe Kontakt), damit wir Sie unterstützen können.