NWC Packaging PowerBench

Note: Make careful changes to the configuration file and make sure that you do not create a syntactically invalid XML file. Be sure to create a backup copy of the current version BEFORE you make any changes. If necessary, you can restore this copy if the changes made do not lead to the desired result.

Setting

Default value

Possible values

Description

ScriptEditorRowMode

Full

Normal / Full / Flat

Defines the display of the lines in standard mode. Normal: Only code selected, expander indented; Full: Whole line selected, expander indented; Flat: Whole line selected, expander flat

EnableScriptEditorMouseOver

True

True / False

In standard mode the lines under the mouse pointer are highlighted.

NiScriptCollapseListParameters

False

True / False

In the eScript view, list parameters (e.g. the text for AddIni) are only displayed as " ... ".

This setting is only available for backward compatibility reasons and should not be used.

ShowNiCommands

True

True / False

Controls whether the root node "DSM Commands" is displayed in the command list with the alias names of Package Deployment commands known from DSM.

ShowCustomDialogs

False

True / False

Controls whether the root node "Custom command dialogs" is displayed with the list of individually created dialogs. This system setting should not be changed.

Language

<not set>

de / en

Defines the display language of the Packaging PowerBench. If no value is specified, the system language is used. If the system language is not supported, the interface is displayed in English.

ShowTestCommands

False

True / False

The commands "All Commands" (corresponds to Administration > Add Module > All Commands > OK), "Load Commands" and "Save Commands" are displayed in the Ribbon and BackstageView menu.

FocusScriptOnInsert

True

True / False

Controls whether the focus is set on the script window after inserting a context menu command.

CommandSelectorBackground

<not set> (means  #FFF6F6F6)

Colour name or ARGB value

Background color of the command selection. 

Examples: "White", "#FFFFFFFF".

TemplatesDirectory

Templates

Valid local or UNC path

Valid path to the template directories

DefaultPackageScriptName

Script.ps1

Default name of the script

Valid script file names.

PackageConverterPath

<not set>

Valid local or UNC path

Path to the DSM Package Converter, if different from the standard.

PackageConverterInclude

.\Common Runtime Files

List of absolute or relative directories

Additional directories to be copied in the package directory when converting DSM packages.

ShowModuleCommands

True

True / False

Controls whether the "Modules" root node is displayed in the command list.

ShowTokenCommands

False

True / False

Controls whether general commands such as loops, conditions etc. are displayed in a separate root node in the command list.

RequireExecutionPolicyBypass

False

True / False

Controls whether to attempt to set the execution policy (for the process) to "Bypass".

ParameterInputTextMode

SimplePowerShell

PowerShell / NiVariable / SimplePowerShell / SimpleDollarOnly

Defines how variables within the Packaging PowerBench are displayed. With the NiVariable setting, you can switch to the familiar DSM display of variable names enclosed in percentage signs.

NamesPopupPlacement

Bottom

Bottom / Top / Left / Right, …

Preferred position for displaying the selection list of variables. The value set corresponds to the values of the enumeration type "System.Windows.Controls.Primitives.PlacementMode" (see  https://docs.microsoft.com/de-de/dotnet/api/system.windows.controls.primitives.placementmode)
Default is "Bottom" = "below, left justified for text selection".

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

Valid PowerShell commands of the Package Deployment Module

Determines which commands create a variable as a result, which is then displayed in the Auto Variable Completion drop-down list.

ColorizedTokenCommands

False

True / False

Controls whether general commands such as loops, conditions, etc. are highlighted in the command list by a different font and color.

HideKeywordCommandDisplayNames

False

True / False

Controls whether for general commands like loops, conditions etc. the descriptive display name is shown in the command tree or only the actual PowerShell command.

UpperCaseRibbonTabCaptions

False

True / False

Controls whether the ribbon tabs (as usual until Office 2013) are labeled in capital letters.

UseDefaultModifiedFileImage

True

True / False

Show default icon (diskette with pen) for modified files.

UseModifiedFileOverlayImage

False

True / False

Use overlay symbol (pencil right below) for modified files. Only valid if "UseDefaultModifiedFileImage" is set to "False".

ShowFileAlreadyOpenMessage

False

True / False

Specifies whether the message "The file ... is already open" is displayed when a file already in the open file is selected.

ShowScriptTasks

False

True / False

Controls whether commands for viewing and editing individual script files are displayed in the ribbon menu.

ShowFileTasks

False

True / False

Controls whether commands for viewing and editing (individual) other files are displayed in the ribbon menu.

AllowEmptyPackageTemplate

False

True / False

If no templates can be found in the template path, new packages can be created without a template if this setting is set to "True".

NewStatementLocation

Before

Before / After

Specifies whether a newly inserted command is inserted before or after the currently selected command in the script.

DefaultPackageLocation

<Not set>

Valid local or UNC path

This setting allows you to specify the default directory under which new packages are to be created. If you do not enter anything here, the default value is the subdirectory "PPB Packages" of the user's document directory.

ShowTemplateBrowseButton

False

True / False

Controls whether a "Browse..." button is displayed on the New Package dialog to be able to select templates outside the template path.

StickyBlockModes

Default

(corresponds to "After")

None = 0

Upon = 1

Before = 2

After = 4

AlsoCollapsed = 8

ExcludeBlocks = 16

IfIncludesElse = 32

UponToFirst = 64

AlsoPipelines = 128

AfterToBeforeLast = 256

Assignment or indentation of new or drag & drop inserted commands / lines to adjacent command/code blocks in standard mode. So the "stickiness" or the "attractiveness" of neighboring blocks.

Default: "Default" = "4" = "After" = (Only) Assign or indent to the last position within the block if the target position is below an expanded block.

None = No automatic indentation

Upon = If on the block statement

Before = If before the block statement

After = If after the block statement

AlsoCollapsed = Even with closed blocks

ExcludeBlocks = No automatic indentation for block commands (on block commands)

IfIncludesElse = "ELSE" can be automatically indented for "IF" blocks

UponToFirst = If on the block statement, then insert as first element

AlsoPipelines = Automatic indent also for pipelines

AfterToBeforeLast = If after the block statement, then insert as penultimate element

SimpleLineDropMarker

True

True / False

Controls whether the line drop marker, which indicates where a command is inserted in the script, is drawn as a simple horizontal line ("True" setting), or as an arrow with indentations and the ability to insert before or after the current selection.

ShowCommandSelectorForStartPanel

False

True / False

Controls whether the command list is also visible in the home screen.

LiveSearchDelay

600

Integer

Number in milliseconds before the search for matching commands is started after the last character has been typed.

FlatCommandModules

True

True / False

Controls whether nodes that represent modules in the command list are placed at the top level ("True" setting) or below a "Module" root node.

HelpFilePath

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

Path to the help files

If the help files are stored in a location other than the default path, you can specify the path here.

AdvancedSelectFolderDialog

True

True / False

Controls whether the selection of a folder (e.g. for "New Package", "Open Package", "Destination Path" etc.) should be done with the classic "Select Folder" dialog or with the modern dialog.

HideParameterNames

Context

Comma-separated list of parameter names

Parameters listed in this setting are hidden in standard mode.

DefaultPackageLocationAlwaysFirstChoice

True

True / False

Controls whether the path of the last opened package is offered as first choice in the New Package dialog (setting False) or the default path configured in the "DefaultPackageLocation" setting.

ConfirmDeleteStatement

True

True / False

Controls whether the deletion of commands must be confirmed.

InstallLocalCommand

${PackageDirectory}\Deploy-Application.exe

Valid command for package execution

Command line that is executed when the local installation of a package is initiated.

InstallLocalArguments

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

Arguments for local installation

Arguments passed to the command line for immediate installation of a package (setting "InstallLocalCommand").

InstallLocalAsAdministrator

False

True / False

Controls whether the script is always executed as local administrator during the local installation or whether it must be activated separately via the corresponding button.

InstallLocalLogFileNameFormat

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

Valid name scheme

Specifies how the log files of the local Installations are named.

InstallLocalLogDirectory

%ProgramData%\NWC Services\PackageDeployment\Logs

Valid paths

Defines where the log files of the local installations are stored.

ShowConditionalCommands

False

True / False

Controls how commands that match conditions are displayed in the command list. Corresponds to the menu item "Conditions" in the "Display" section of the "View" tab.

What is interpreted as a condition can be defined via "ConditionalCommandVerbs".

ConditionalCommandVerbs

Test

Verbs of PowerShell-Cmdlets

All cmdlets with these verbs are evaluated as "conditional commands" and are displayed or not displayed according to the "ShowConditionalCommands" setting.

ExpandAllScriptBlocks

True

True / False

Controls whether script blocks such as loops or if conditions are displayed expanded or collapsed by default.

InitialLetterDelay

600

Integer

Duration in milliseconds after which a newly entered letter is no longer added to the previous entries when jumping to matching commands, but is considered the new first letter.

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

Display of the categories in the command list.

None = None

Selector = Selection combobox for categories

Modules = For each module

Global = On top level below "Categories

SelectorBelowSearch = Selection-combobox below "Search:"

NiCommands = For "DSM Commands" node

PackageDeployment = For node/module "PackageDeployment"

AutoHideSelector = Show selection combobox only in list view - hide in tree view

FlatGlobal = Directly at top level (i.e. without "Categories" node - only effective in conjunction with "Global")

CustomPsHost

True

True / False

Controls whether the script is executed in a dedicated PowerShell host or from the default App Deployment Toolkit host.

VariableCompletionAssist

True

True / False

Controls whether the opening curly bracket can be omitted when entering variables (only valid if "ParameterInputTextMode" is configured to "SimplePowershell").

RegistryEditorColumns

135,70,400

Comma separated list of the three column widths in pixels or "Auto" for automatic width

Defines the initial column width of the "Name", "Type" and "Data" columns of the registry editor. Changed values are saved per user and reused next time.

StartPageAsTab

True

True / False

Determines whether the home page is displayed permanently as a tab.

MainWindowBounds

<not set>

Left, Top, Width, Height

Coordinates of the PPB window in pixels.

MainWindowState

<not set>

Normal / Maximized

Determines whether the PPB window is maximized or displayed normally.

DefaultExportDestinationFolder

<not set>

Valid local or UNC path

Default output path for package export

ShowEditorsCommands

False

True / False

Controls whether the "Load Editors" button is displayed in the "Management" ribbon.

ShowStyleCommands

False

True / False

Controls whether the "Load Style Definition" button is displayed in the "Management" ribbon.

ShowTestCommands

False

True / False

Controls whether the test commands "All Commands", "Load Commands" and "Save Commands" are available.

ShowRevisionCreatedMessage

True

True / False

Controls whether a corresponding message is displayed after the revision directory has been created.

ShowRevisionIncrementedMessage

True

True / False

Controls whether a message is displayed after a new package revision is created.

UseWebProxy

False

True / False

Controls whether a web proxy is used for accessing the Internet.

WebProxyHost

<not set>

Name or IP-address

Contains name or IP address of the web proxy, if needed.

WebProxyPort

<not set>

Port-Number

Contains the port on which the web proxy is reached.

WebProxyUseDefaultCredentials

True

True / False

Controls whether default credentials or whether the specified proxy user is used. 

WebProxyAccountUser

<not set>

Username

Username used for proxy authentication.

WebProxyAccountPassword

<not set>

Password

Password of the user used for proxy authentication.