Exit-Package

Beendet das aktuelle Installationspaket mit dem angegebenen Status und optionalem Kommentar. 


Befehlseingaben:

  • Wie soll dieses Paket protokolliert werden?
    Legt fest, mit welchem Status das Paket beendet wird.
    • Als komplett ausgeführtes Paket
      Diese Option bewirkt, dass die Status-Informationen zur erfolgreichen Installation in die Registry geschrieben werden. Bei Paketen mit Benutzerteil, werden die Einträge für das Active Setup erstellt. Der Returncode 0 wird an den Aufrufer des Pakets zurückgegeben, sofern kein abweichender Rückgabewert angegeben wurde.
    • Als nicht ausgeführtes Paket
      Diese Option bewirkt, dass Status-Informationen zur Paket-Ausführung in die Registry geschrieben werden, der IsInstalled-Value wird jedoch auf 0 und der Status-Value auf Undone gesetzt, um zu dokumentieren, dass das Paket nicht als installiert beziehungsweise ausgeführt betrachtet wird. Bei Paketen mit Benutzerteil, werden die Einträge für das Active Setup nicht erstellt. Der Returncode 1602 wird an den Aufrufer des Pakets zurückgegeben, sofern kein abweichender Rückgabewert angegeben wurde.
    • Als fehlgeschlagen
      Diese Option bewirkt, dass Status-Informationen zur Paket-Ausführung in die Registry geschrieben werden, der IsInstalled-Value wird jedoch auf 0 und der Status-Value auf Failed gesetzt, um zu dokumentieren, dass das Paket als fehlgeschlagen und nicht installiert betrachtet wird. Bei Paketen mit Benutzerteil, werden die Einträge für das Active Setup nicht erstellt. Der Returncode 69002 wird an den Aufrufer des Pakets zurückgegeben, sofern kein abweichender Rückgabewert angegeben wurde.
  • Rückgabewert
    Optionale Möglichkeit, einen von den Standard-Returncodes abweichenden Rückgabewert zu definieren. Dieser wird dann an den Aufrufer des Paketes zurückgegeben, unabhängig davon, welche Protokollierungsoption Sie gewählt haben.
  • Letzter Kommentar
    Kommentar zum Beenden des Pakets, der im Logfile und im Wert StatusMessage der Registry erfasst wird.


Beispiel:

Dieses Beispiel beendet das Script mit dem Status fehlgeschlagen, gibt den Rückgabewert 5 an den Aufrufer zurück und fügt den Kommentar in die Protokolldatei ein.


Entspricht DSM eScript Befehlen:

  • ExitProc
  • ExitProcEx


Siehe auch: