Konfigurationseinstellungen

Aussehen und Verhalten der Packaging PowerBench können über die Konfigurationsdatei PackagingPowerBench.exe.config, die sich im Installationsverzeichnis befindet, konfiguriert werden. In der aktuellen Version stehen folgende Einstellungen zur Verfügung:

Hinweis: Nehmen Sie Änderungen an der Konfigurationsdatei mit Bedacht vor und achten Sie darauf, kein syntaktisch ungültiges XML-File zu erzeugen. Erzeugen Sie auf jeden Fall VOR jeder Änderung eine Sicherungskopie der aktuellen Version, die Sie im Bedarfsfall wiederherstellen können, sofern die vorgenommenen Änderungen nicht zum gewünschten Ergebnis führen.


Einstellung

Standardwert

Mögliche Werte

Beschreibung

ScriptEditorRowMode

Full

Normal / Full / Flat

Legt die Darstellung der Zeilen im Standard-Modus fest. Normal: Nur Code markiert, Expander eingerückt; Full: Ganze Zeile markiert, Expander eingerückt; Flat: Ganze Zeile markiert, Expander flach

EnableScriptEditorMouseOver

True

True / False

Im Standard-Modus werden die Zeilen unter dem Mauszeiger farblich hervorgehoben.

NiScriptCollapseListParameters

False

True / False

In der eScript-Ansicht werden Listen-Parameter (z.B. der Text bei AddIni) nur als " … " dargestellt.
Diese Einstellung ist nur noch aus Abwärtskompatibilitätsgründen vorhanden und sollte nicht verwendet werden.

ShowNiCommands

True

True / False

Legt fest, ob der Root-Knoten "DSM-Kommandos" mit den aus DSM bekannten Alias-Namen der Package Deployment Befehle in der Befehlsliste angezeigt wird.

ShowCustomDialogs

False

True / False

Legt fest, ob der Root-Knoten "Benutzerdefinierte Kommando-Dialoge" mit der Liste der individuell erstellten Dialoge angezeigt wird. Diese Systemeinstellung sollte nicht verändert werden.

Language

<nicht gesetzt>

de / en

Legt die Anzeigesprache der PPB fest. Wird kein Wert angegeben, wird die Systemsprache verwendet. Wird die Systemsprache nicht unterstützt, wird die Oberfläche in englisch angezeigt.

ShowTestCommands

False

True / False

Die Kommandos "Alle Kommandos" (entspricht Verwaltung > Modul hinzufügen > Alle Kommandos > OK), "Kommandos laden" und "Kommandos speichern" werden im Ribbon- und im BackstageView-Menü angezeigt.

FocusScriptOnInsert

True

True / False

Legt fest, ob der Fokus nach dem Einfügen eines Befehls aus dem Kontextmenü auf das Scriptfenster gesetzt wird.

CommandSelectorBackground

<nicht gesetzt> (bedeutet #FFF6F6F6)

Farbname oder ARGB-Wert

Hintergrundfarbe der Kommando-Auswahl. 

Beispiele: "White", "#FFFFFFFF".

TemplatesDirectory

Templates

Gültiger lokaler oder UNC-Pfad

Gültiger Pfad zu den Vorlagenverzeichnissen.

DefaultPackageScriptName

Script.ps1

Standardname des Scripts

Gültige Script-Dateinamen.

PackageConverterPath

<nicht gesetzt>

Gültiger lokaler oder UNC-Pfad

Pfad zum DSM-Package-Converter, sofern vom Standard abweichend.

PackageConverterInclude

.\Common Runtime Files

Liste von absoluten oder relativen Verzeichnissen

Im Rahmen der Konvertierung von DSM-Paketen zusätzlich in der Paketverzeichnis zu kopierende Verzeichnisse.

ShowModuleCommands

True

True / False

Legt fest, ob der Knoten "Module" in der Befehlsliste angezeigt wird.

ShowTokenCommands

False

True / False

Legt fest, ob allgemeine Kommandos wie Schleifen, Bedingungen etc. in einem eigenen Root-Knoten in der Befehlsliste angezeigt werden.

RequireExecutionPolicyBypass

False

True / False

Legt fest, ob versucht wird, die Ausführungsrichtlinie (für den Prozess) auf "Bypass" zu setzen.

ParameterInputTextMode

SimplePowerShell

PowerShell / NiVariable / SimplePowerShell / SimpleDollarOnly

Legt fest, wie Variablen innerhalb der PPB dargestellt werden. Mit der Einstellung NiVariable können Sie auf die aus DSM gewohnte Darstellung von in Prozentzeichen eingeschlossenen Variablennamen umschalten.

NamesPopupPlacement

Bottom

Bottom / Top / Left / Right, …

Bevorzugte Position für die Anzeige der Auswahlliste der Variablen. Die Wertemenge entspricht den Werten des Aufzählungstyps "System.Windows.Controls.Primitives.PlacementMode" (vgl. z.B. https://docs.microsoft.com/de-de/dotnet/api/system.windows.controls.primitives.placementmode)
Vorgabe ist "Bottom" = "unterhalb, linksbündig zur Textauswahl"

CustomVariableSetters

Set-PdVar, Start-Program:ExitCodeVariable, Start-ProgramAs:ExitCodeVariable, Read-RegistryValue:ValueVariable, Read-IniFileValue:ValueVariable, Read-StringElement:ResultVariable, Read-LeftString:ResultVariable, Read-MidString:ResultVariable, Read-ReplacePattern:ResultVariable, Read-ReplaceString:ResultVariable, Read-RightString:ResultVariable, Read-FileVersion:ResultVariable, Read-WmiObject:ResultVariablePrefix, Read-WmiObjectCount:ResultVariable, Read-IndexedWmiObject:ResultVariablePrefix, Search-RegistryKey:ResultVariable, Read-XmlNode:IndexVariable, Read-XmlNode:ResultVariable, Install-MsiProduct:ResultVariable, Uninstall-MsiProduct:ResultVariable, Install-MsiPatch:ResultVariable, Repair-MsiProduct:ResultVariable, Install-MsiFeature:ResultVariable

Gültige PowerShell-Befehle des Package Deployment Moduls

Legt fest, welche Befehle als Ergebnis eine Variable erzeugen, die dann in der Dropdown-Liste der automatischen Variablenvervollständigung angezeigt wird.

ColorizedTokenCommands

False

True / False

Legt fest, ob allgemeine Kommandos wie Schleifen, Bedingungen etc. in der Befehlsliste besonders hervorgehoben, durch andere Schriftart und -farbe.

HideKeywordCommandDisplayNames

False

True / False

Legt fest, ob bei den allgemeinen Kommandos wie Schleifen, Bedingungen etc. der beschreibende Anzeigename im Befehlsbaum angezeigt wird oder nur das eigentliche PowerShell Kommando.

UpperCaseRibbonTabCaptions

False

True / False

Legt fest, ob die Beschriftung der Ribbon-Tabs (wie bis Office 2013 üblich) in Großbuchstaben erfolgt.

UseDefaultModifiedFileImage

True

True / False

Standardsymbol (Diskette mit Stift) bei modifizierten Dateien anzeigen.

UseModifiedFileOverlayImage

False

True / False

Überlagerungssymbol (Stift rechts unten) bei modifizierten Dateien verwenden. Nur sinnvoll, wenn "UseDefaultModifiedFileImage" auf "False" gesetzt ist.

ShowFileAlreadyOpenMessage

False

True / False

Legt fest, ob die Meldung "Die Datei … ist bereits geöffnet." angezeigt wird, wenn eine bereits in der PPB geöffnete Datei ausgewählt wird.

ShowScriptTasks

False

True / False

Legt fest, ob Kommandos zum Anzeigen und Bearbeiten einzelner Skript-Dateien im Ribbon-Menü angezeigt werden.

ShowFileTasks

False

True / False

Legt fest, ob Kommandos zum Anzeigen und Bearbeiten (einzelner) sonstiger Dateien im Ribbon-Menü angezeigt werden.

AllowEmptyPackageTemplate

False

True / False

Sollten im Vorlagenpfad keinerlei Vorlagen zu finden sein, können - wenn diese Einstellung auf "True" gesetzt ist - neue Pakete auch ganz ohne Vorlage angelegt werden.

NewStatementLocation

Before

Before / After

Legt fest, ob ein neu eingefügter Befehl vor oder nach dem aktuell markierten Befehl im Script eingefügt wird.

DefaultPackageLocation

<nicht gesetzt>

Gültiger lokaler oder UNC-Pfad

Mit dieser Einstellung können Sie das Standardverzeichnis, unter dem neue Pakete angelegt werden sollen, angeben. Wenn Sie hier nichts eintragen, ist der Defaultwert das Unterverzeichnis "PPB Packages" des Dokumente-Verzeichnis des Benutzers.

ShowTemplateBrowseButton

False

True / False

Legt fest, ob auf dem Neues Paket-Dialog ein "Durchsuchen..."-Button angezeigt wird, um auch Vorlagen außerhalb des Vorlagenpfads auswählen zu können.

StickyBlockModes

Default

(entspricht After)

None = 0

Upon = 1

Before = 2

After = 4

AlsoCollapsed = 8

ExcludeBlocks = 16

IfIncludesElse = 32

UponToFirst = 64

AlsoPipelines = 128

AfterToBeforeLast = 256

Zuordnung bzw. Einrückung von neu oder per Drag & Drop eingefügten Kommandos / Zeilen zu benachbarten Kommando-/Code-Blöcken im Standard-Modus. Also der "Klebrigkeit" oder der "Attraktivität" benachbarter Blöcke.


Vorgabe: "Default" = "4" = "After" = (Nur) Zuordnen bzw. Einrücken an die letzte Position innerhalb des Blockes, wenn die Zielposition unterhalb eines aufgeklappten Blockes ist.


None = Keine automatische Einrückung

Upon = Wenn auf der Block-Anweisung

Before = Wenn vor der Block-Anweisung

After = Wenn nach der Block-Anweisung

AlsoCollapsed = Auch bei zugeklappten Blöcken

ExcludeBlocks = Keine automatischen Einrückung für Block-Kommandos (auf Block-Kommandos)

IfIncludesElse = "ELSE" kann bei "IF"-Blöcken automatisch eingerückt werden

UponToFirst = Wenn auf der Block-Anweisung, dann als erstes Element einfügen

AlsoPipelines = Auch bei Pipelines automatisch einrücken

AfterToBeforeLast = Wenn nach der Block-Anweisung, dann als vorletztes Element einfügen

SimpleLineDropMarker

True

True / False

Legt fest, ob die Einfügemarke, die anzeigt, an welcher Stelle ein Befehl im Script eingefügt wird, als simple horizontale Linie gezeichnet wird (Einstellung "True"), oder ob ein Pfeil mit Einrückungen und der Möglichkeit, vor oder nach der aktuellen Markierung einzufügen.

ShowCommandSelectorForStartPanel

False

True / False

Legt fest, ob die Befehlsliste auch im Startbildschirm zu sehen ist.

LiveSearchDelay

600

Integer-Zahl

Anzahl in Millisekunden, bevor nach dem Eintippen des letzten Zeichens mit der Suche nach passenden Befehlen begonnen wird.

FlatCommandModules

True

True / False

Legt fest, ob Knoten, die in der Befehlsliste Module repräsentieren, auf oberster Ebene eingeordnet werden (Einstellung "True") oder unterhalb eines Root-Knotens "Module".

HelpFilePath

.\Docs\%Culture%\NWC Packaging PowerBench.chm

Pfad zu den Hilfedateien

Sollten die Hilfedateien an anderer Stelle als dem Standardpfad abgelegt sein, können Sie hier den Pfad angeben.

AdvancedSelectFolderDialog

True

True / False

Legt fest, ob die Auswahl eines Ordners (z.B. bei "Neues Paket", "Paket öffnen", "Zielpfad" usw.) mit dem klassischen "Ordner auswählen" Dialog erfolgen soll oder mit dem modernen Dialog.

HideParameterNames

Context

Mit Kommas getrennte Liste von Parameternamen

In dieser Einstellung aufgelistete Parameter werden im Standard-Modus ausgeblendet.

DefaultPackageLocationAlwaysFirstChoice

True

True / False

Legt fest, ob im Neues Paket Dialog der Pfad des zuletzt geöffneten Pakets als erste Wahl angeboten wird (Einstellung False) oder der in der Einstellung "DefaultPackageLocation" konfigurierte Standardpfad.

ConfirmDeleteStatement

True

True / False

Legt fest, ob das Löschen von Befehlen bestätigt werden muss.

InstallLocalCommand

${PackageDirectory}\Deploy-Application.exe

Gültiges Kommando zur Paketausführung

Kommandozeile, die bei Aufruf der Sofort-Installation eines Pakets ausgeführt wird.

InstallLocalArguments

-InstallMode ${InstallMode} -LogFileName '${LogFileName}' -LogDirectory '${LogDirectory}'

Argumente zur Sofort-Installation

Argumente, die an die Kommandozeile zur Sofort-Installation eines Pakets (Einstellung "InstallLocalCommand") übergeben werden.

InstallLocalAsAdministrator

False

True / False

Legt fest, ob das Script bei der Sofort-Installation immer als lokaler Administrator ausgeführt wird oder ob das separat über die entsprechende Schaltfläche zugeschaltet werden muss.

InstallLocalLogFileNameFormat

InstallLocal_${PackageName}_${InstallMode}_${Timestamp}.log

Gültiges Namensschema

Legt fest, wie die Protokolldateien der Sofort-Installationen benannt werden.

InstallLocalLogDirectory

%ProgramData%\NWC Services\PackageDeployment\Logs

Gültige Pfade

Legt fest, wo die Protokolldateien der Sofort-Installationen abgelegt werden.

ShowConditionalCommands

False

True / False

Legt fest, wie Kommandos, die Bedingungen entsprechen, in der Befehlsliste angezeigt werden. Entspricht dem Menüpunkt "Bedingungen" im Abschnitt "Anzeigen" des Registers "Ansicht".

Was als Bedingung interpretiert wird, kann über "ConditionalCommandVerbs" definiert werden.

ConditionalCommandVerbs

Test

Verben von PowerShell-Cmdlets

Alle Cmdlets mit diesen Verben werden als "Conditional Commands" bewertet und gemäß der Einstellung "ShowConditionalCommands" angezeigt oder nicht.

ExpandAllScriptBlocks

True

True / False

Legt fest, ob Script-Blocks wie Schleifen oder If-Bedingungen standardmäßig auf- oder zugeklappt angezeigt werden.

InitialLetterDelay

600

Integer-Zahl

Dauer in Millisekunden, nach der ein neu eingegebener Buchstabe beim Springen zu passenden Befehlen nicht mehr zu den vorigen Eingaben hinzugefügt wird, sondern als neuer erster Buchstabe betrachtet wird.

CommandCategoryMode

Default

(entspricht NiCommands | PackageDeployment | Selector | SelectorBelowSearch | AutoHideSelector)

None = 0,

Selector = 1

Modules = 2

Global = 4

SelectorBelowSearch = 8

NiCommands = 16

PackageDeployment = 32

AutoHideSelector = 64

FlatGlobal = 128

Darstellung der Kategorien in der Befehlsliste.


None = Keine

Selector = Auswahl-ComboBox für Kategorien

Modules = Für jedes Modul

Global = Auf oberster Ebene unterhalb "Kategorien"

SelectorBelowSearch = Auswahl-ComboBox unterhalb "Suchen:"

NiCommands = Für Knoten "DSM Kommandos"

PackageDeployment = Für Knoten/Modul "PackageDeployment"

AutoHideSelector = Auswahl-ComboBox nur in der Listen-Ansicht anzeigen – in der Baum-Ansicht ausblenden

FlatGlobal = Direkt auf oberster Ebene (d.h. ohne "Kategorien"-Knoten - nur wirksam in Verbindung mit "Global")

CustomPsHost

True

True / False

Legt fest, ob die Ausführung des Scripts in einem eigenen PowerShell Host stattfindet oder über den Standardhost des App Deployment Toolkits.

VariableCompletionAssist

True

True / False

Legt fest, ob bei der Eingabe von Variablen auf die öffnende geschweifte Klammer verzichtet werden kann (nur gültig, wenn "ParameterInputTextMode" auf "SimplePowershell" konfiguriert).

RegistryEditorColumns

135,70,400

Kommagetrennte Liste der drei Spaltenbreiten in Pixel oder "Auto" für automatische Breite

Legt die initiale Spaltenbreite der Spalten "Name", "Typ" und "Daten" des Registry-Editors fest. Veränderte Werte werden pro Benutzer gespeichert und beim nächsten Mal wiederverwendet.

StartPageAsTab

True

True / False

Legt fest, ob die Startseite dauerhaft als Register angezeigt wird.

MainWindowBounds

<nicht gesetzt>

<Links>, <Oben>, <Breite>, <Höhe>

Koordinaten des PPB Fensters in Bildpunkten.

MainWindowState

<nicht gesetzt>

Normal / Maximized

Legt fest, ob das Fenster der PPB maximiert oder normal angezeigt wird.

DefaultExportDestinationFolder

<nicht gesetzt>

Gültiger lokaler oder UNC-Pfad

Standard-Ausgabepfad für den Paket-Export

ShowEditorsCommands

False

True / False

Legt fest, ob die Schaltfläche "Dialoge laden" im Ribbon "Verwaltung" angezeigt wird.

ShowStyleCommands

False

True / False

Legt fest, ob die Schaltfläche "Stil-Definition laden" im Ribbon "Verwaltung" angezeigt wird.

ShowTestCommands

False

True / False

Legt fest, ob die Test-Befehle "Alle Kommandos", "Kommandos laden" und "Kommandos speichern" verfügbar sind

ShowRevisionCreatedMessage

True

True / False

Legt fest, ob nach dem Erzeugen des Revisions-Verzeichnisses eine entsprechende Meldung angezeigt wird.

ShowRevisionIncrementedMessage

True

True / False

Legt fest, ob nach dem Erstellen einer neuen Paket-Revision eine entsprechende Meldung angezeigt wird.

UpgradeSettings

True

True / False

Legt fest, ob beim ersten Start einer neueren PPB-Version angeboten wird, die bisherige Einstellungen zu übernehmen.

UseWebProxy

False

True / False

Legt fest, ob ein Proxy für den Internet-Zugang verwendet wird.

WebProxyHost

<nicht gesetzt>

Name oder IP-Adresse

Enthält Name oder IP-Adresse des Web-Proxys, sofern benötigt.

WebProxyPort

<nicht gesetzt>

Port-Nummer

Enthält den Port, auf dem der Web-Proxy erreicht wird.

WebProxyUseDefaultCredentials

True

True / False

Legt fest, ob die Standard-Anmeldeinformationen oder ob der angegebenen Proxy-User verwendet wird. 

WebProxyAccountUser

<nicht gesetzt>

Benutzername

Benutzername, der zur Proxy-Authentifizierung verwendet wird.

WebProxyAccountPassword

<nicht gesetzt>

Kennwort

Kennwort des Benutzers, der zur Proxy-Authentifizierung verwendet wird.

FlagsCheckBoxPosition

Right

Left / Right

Legt die Positionierung der Kontrollkästchen in den Einstellungen fest (links oder rechts von der Beschreibung).

UseCodeSigningCertificatePath

None

None = Paketdateien nicht digital signieren

Store = Zertifikat aus Zertifikatspeicher wählen

File = Zertifikatsdatei verwenden

Legt fest, ob Paketdateien eine digital signiert werden sollen und falls ja, aus welcher Quelle das zu verwendende Zertifikat stammt.

CodeSigningCertificateStorePath

<nicht gesetzt>

Gültiger Pfad

Pfad zum zu verwendenden Codesigning-Zertifikat im PowerShell Cert:-Laufwerk.

CodeFilesToSign

Script.ps1

Zu signierende Paketdatei(en)

Kommagetrennte Liste der Paketdateien, die digital signiert werden sollen.

CodeSigningTimestampServer

<nicht gesetzt>

Gültige URL

URL zum Zeitstempel-Server für die Signatur. Eine Liste öffentlicher Timestamp-Server finden Sie beispielsweise unter https://gist.github.com/Manouchehri/fd754e402d98430243455713efada710

CodeSigningHashAlgorithm

SHA256

SHA256 / SHA1 / MD5

Algorithmus, der für die Berechnung des Signatur-Hashes verwendet werden soll. Die Verwendung von SHA256 wird empfohlen, sofern keine triftigen Gründe dagegen sprechen.

CodeSigningCertificateFilePath

<nicht gesetzt>

Gültiger Pfad

Pfad zur zu verwendenden Codesigning-Zertifkatsdatei (.pfx-Datei (Personal Information Exchange)).

CodeSigningCertificateFilePassword

<nicht gesetzt>

Gültiges Kennwort

Kennwort des privaten Schlüssels des in der Zertifikatsdatei gespeicherten Zertifikats.

RegistryEditorAutoRecurseWow64

False

True / False

Legt fest, ob die Einstellung der Eigenschaft "32-Bit Modus verwenden" vererbt wird.

RegistryEditorAutoRecurseRepair

False>

True / False

Legt fest, ob die Einstellung der Eigenschaft "Werte bei Repair neu schreiben" vererbt wird.

RegistryEditorAutoRecurseUninstall

False

True / False

Legt fest, ob die Einstellung der Eigenschaft "Werte bei Deinstallation löschen" vererbt wird.

SetExecutionPolicy

<nicht gesetzt>

Unrestricted / RemoteSigned / AllSigned / Restricted / Default / Bypass / Undefined

Bestimmt die Ausführungsrichtlinie, die über „Set-ExecutionPolicy“ gesetzt wird. Ist der Wert leer, dann wird „Set-ExecutionPolicy“ nicht aufgerufen – d.h. kein explizites Setzen der Ausführungsrichtlinie.

ReplaceSelectionOnPaste

True

True / False

Legt fest, ob eine bestehende Auswahl beim Einfügen von Zwischenablageinhalt überschrieben wird.

LogLevel

Information

Off / Critical / Error / Warning / Information / Verbose / All

Legt fest, welchen Detaillierungsgrad das Logfile der Packaging PowerBench hat.

LogPath

%ProgramData%\NWC Services\Logs

Gültige Pfade

Legt den Pfad der Protokolldatei der Packaging PowerBench fest.

LogFileName

&lt;application&gt;_&lt;timestamp&gt;.log

Gültiges Namensschema

Legt den Namen der Protokolldatei der Packaging PowerBench fest.

OverwriteExistingPackage

Disallow

Disallow / Merge / MergeAdjustRevision / Delete

Legt fest, wie mit bestehenden Verzeichnissen umgegangen werden soll, wenn diese als Paketverzeichnis eines neuen Pakets ausgewählt werden.

StartupCommandsXmlName

Startup.DsmView.Commands.xml

Gültiger Dateiname

Legt fest, welche StartupCommands-Datei beim Start der Packaging PowerBench geladen wird.

StartupScriptPanelStylesName

<nicht gesetzt>

Gültiger Dateiname

Legt fest, welche Stil-Datei beim Start der Packaging PowerBench geladen wird.

DisableReloadStartupSettings

False

True / False

Wenn auf True gesetzt, werden geänderte Einstellungen erst beim Neustart der PPB wirksam.

ShowLineNumbers

True

True / False

Legt fest, ob im Expertenmodus die Spalte mit den Zeilennummern angezeigt wird.

Theme

<nicht gesetzt>

Gültiges Theme

Legt das Farbschema des PPB Hauptfensters fest.

EnableProvisionalThemesEditor

False

True / False

Entwickleroption! Legt fest, ob das Ribbon-Tab für den Hilfs-Themeeditor angezeigt wird.

LineNumbersMinDigits

3

Integer

Anzahl reservierter Stellen in der Zeilennummernansicht des Expertenmodus