Weitere Konfigurationsoptionen

opsi-script.global.debug_prog : boolean
Wenn false, werden Logmeldungen, welche zum Debuggen des opsi-script selbst dienen, nicht ausgegeben, soweit es sich nicht um Warnungen oder Fehler handelt.
Default: false
Damit werden die Logdateien entlastet und nur noch Meldungen, die Skript-relevant sind, stehen in den Logdateien. Die Umstellung der entsprechenden Logmeldungen im Quellcode des opsi-script ist noch nicht abgeschlossen und wird bei ca. 1700 Log-Aufrufen auch noch etwas dauern.

opsi-script.global.debug_lib : boolean
Wenn false, so werden Logmeldungen aus lokalen Funktionen, welche aus Libraries importiert wurden, nur ausgegeben, soweit es sich um Warnungen oder Fehler handelt.
Der Wert kann innerhalb eines Skriptes mit der Anweisung SetDebug_Lib überschrieben werden.
Default : false
siehe auch SetDebugLib

opsi-script.global.default_loglevel : intstr
Setzt (überschreibt) den Standard default Loglevel von opsi-script.
Dieser Config hat keinen Einfluss auf Skripte, bei denen der Loglevel per setLogLevel explizit gesetzt worden ist.
Default : '7'
siehe auch SetLogLevel
siehe auch [opsi-script-configs_force_min_loglevel]

opsi-script.global.force_min_loglevel : intstr
Erzwingt einen minimalen Loglevel.
Dies dient dazu, bei der Entwicklung und/oder Fehlersuche gezielt und temporär für einzelne Clients den Loglevel zu erhöhen ohne hierzu Anpassungen am Skript vornehmen zu müssen.
Default: '0'
siehe auch SetLogLevel
siehe auch [opsi-script-configs_default_loglevel]

opsi-script.global.ScriptErrorMessages : boolean
Wenn false, werden Syntax-Fehlermeldungen nicht interaktiv ausgegeben sondern nur in die Logdatei geschrieben. Im Produktivbetrieb ist es sinnvoll, dass dieser Parameter false ist. Daher ist der Default für diesen Config false. Der Default von opsi-script für diesen Parameter ist (aus historischen Gründen) true. Im Servicekontext überschreibt der Config den Default von opsi-script. Außerhalb des Servicekontext gilt der Default von opsi-script. Diese Default-Werte können innerhalb eines Skriptes mit der Anweisung ScriptErrorMessages überschrieben werden.
Default: false
siehe auch : ScriptErrorMessages

opsi-script.global.AutoActivityDisplay : boolean
Wenn true, wird während des Laufs von externen Prozessen (winbatch,ShellScript,execwith Sektionen) ein (marquee) Fortschrittsbalken (der Endlos durch läuft) angezeigt.
Default: true
siehe auch : AutoActivityDisplay

opsi-script.global.supresssystemencodingwarning : boolean
Wenn true, wird die Warnung: Encoding=system makes the opsiscript not portable between different OS unterdrückt.
Default: false
siehe auch : encoding

opsi-script.global.reverseproductorderbyuninstall : boolean
Wenn true, wird die ProductListe umsortiert, so dass uninstall-Aktionen als erstes und in umgekehrter Reihenfolge der Installation durchgeführt werden.
Default: false

opsi-script.global.log_rotation_count : string (number) // seit 4.12.4.29
Gibt die Anzahl der lokal auf dem Client gesicherten Backups des opsi-script.log an. (opsi-script_0.log, opsi-script_1.log, …​)
Default = 8 ; Maximal = 999

opsi-script.global.writeProductLogFile : boolean // seit 4.12.4.35
Wenn true, wird auf dem Client im Unterverzeichnis lastprodlogs des opsi-script Logverzeichnisses ( z.B. c:\opsi.org\log\lastprodlogs) für jedes opsi-Produkt eine eigene Logdatei geschrieben. Der Name der Logdatei ist <productId>.log. Es existiert dann für jedes Produkt der Log des letzten Skriptlaufs. Im Fall, dass ein Skript Reboots innerhalb des Skriptes beinhaltet, so enthält dieses Log nur den Teil nach dem letzten Reboot.
Default: false

opsi-script.global.testsyntax : boolean // seit 4.12.7.0
Wenn true, werden die Skripte von opsi-script im testsyntax-Modus ausgeführt.
Default: false
siehe auch: [opsi-script-testsyntax]

ASCII, plain ASCII
ASCII ist eine Abkürzung von: American Standard Code for Information Interchange
'plain ascii': 7 Bit pro Zeichen; kann 128 verschiedene Zeichen darstellen. Hier enthalten sind die arabischen Ziffern, die Zeichen des lateinischen Alphabetes in Groß- und Kleinschreibung sowie eine Reihe von Sonder- und Steuerzeichen.
Diese 128 Zeichen finden sich auch in den nachfolgend beschriebenen Erweiterungen wieder.

ANSI, Codepages
Verwendet 8 Bit pro Zeichen (also ein Byte). Damit können Die ersten (unteren) 128 Zeichen entsprechen plain ASCII. Die oberen 128 Zeichen sind für unterschiedliche Alphabete in unterschiedlichen 'Codepages' definiert. Bekannte 'code pages':
Windows-1252 = CP1252 = ISO 8851-1 = Western Europe code page.
Die 256 Zeichen von CP1252 sind auch die Basis von Unicode UTF-16.
'ANSI' ist eine Abkürzung von: American National Standards Institute:
https://stackoverflow.com/questions/701882/what-is-ansi-format :
'ANSI encoding is a slightly generic term used to refer to the standard code page on a system, ( …​ )The name "ANSI" is a misnomer, since it does not correspond to any actual ANSI standard, but the name has stuck.'
In Deutsch:
'ANSI encoding ist ein verbreiteter Begriff um sich auf die Standard code page eines Systems zu beziehen. (…​.) Der Name "ANSI" ist allerdings falsch und irreführend, da es keinen entsprechenden ANSI-Standard gibt. Trotzdem ist der Begriff allgemein üblich.'
Was ist dann mit dem Begriff ANSI encoding gemeint ?
https://wiki.freepascal.org/Character_and_string_types#AnsiChar says:
'A variable of type AnsiChar, also referred to as char, is exactly 1 byte in size, and contains one "ANSI" (local code page) character.'
In Deutsch:
'Ein ANSI Zeichen hat eine Länge von einem Byte und ist gemäß der lokalen code page definiert.'
Die Probleme mit der Verwendung von Codepages sind:

Unicode, UTF-8
'Unicode' ist (wie 'ANSI') eine Encodingfamilie (nicht ein Encoding).
Der bedeutendste Unterschied im Vergleich zu code pages ist, das um ein Zeichen zu codieren hier bis zu 4 Bytes verwendet werden. Damit können 'alle' Alphabete in einem Encoding untergebracht werden.
Die wichtigsten Mitglieder der 'Familie' Unicode sind:

encoding=<encoding>
Seit Version 4.11.4.1 kann bei einem Script (egal ob Hauptscript, sub, include oder library) das encoding auch angegeben werden. Dazu gibt es den Befehl:
encoding=<encoding>
Dieser Befehl kann an einer beliebigen Stelle in der Scriptdatei stehen.
Wird dieser Befehl nicht gefunden, so wird zunächst davon ausgegangen, das das Encoding der Datei dem Systemencoding des laufenden Betriebssystems entspricht. Unter Linux und macOS wäre dies UTF-8. Unter Windows ist dies ein cp* abhängig von der Lokalisierung. In Westeuropa z.B. cp1252.
Wenn die einzulesende Datei Umlaute enthält (also nicht nur 'plain ASCII' ist), so führt das fehlen der Zeile encoding=utf8 zu der Warnung:
'Encoding=system makes the opsiscript not portable between different OS'.
Diese Warnung kann unterdrückt werden durch den config (Hostparameter):
opsi-script.global.supresssystemencodingwarning = true.
siehe auch [opsi-script-configs_supresssystemencodingwarning]
Wenn die einzulesende Datei Umlaute enthält (also nicht nur 'plain ASCII' ist) und es einen Widerspruch zwischen dem detektierten Encoding (z.B. über ein BOM) und dem impliziten Encoding system bzw. dem per encoding= angegebenen Encoding gibt, so wird folgende Warnung in das Log geschrieben:
'Warning: Given encodingString <> is different from the expected encoding <>'

Bei der Verwendung von encoding=<encoding>
kann <encoding> ist eines der folgenden Werte sein: