MasterPromptPS

Usage

Parameters

Examples

Settings File

• Informational labels using WMI as the data source
• Text fields with max length parameter and WMI data as source for default text
• Dropdown lists and cascade dropdown lists
• Masked password fields which store data as encrypted text
• Checkboxes and Radio buttons

Global Settings

• width: The width of the dialog box
• height: The height
• rowheight: The height of each field row
• labelcolumnX: The initial horizontal position of the label column in pixels
• fieldcolumnX: The initial horizontal position of the field column in pixels
• rowy: The vertical position of the first field row in pixels
• textboxsize: The length of text boxes, password fields, dropdown lists and radio button groups in pixels
• title: The window title
• header: Text to appear beside the logo in the header of the form
• footer: Text to appear in the footer of the form (not currently enabled)
• errorcolor: Set the background of text, password and select field if they do not validate

Field Types

Common Parameters

• type: [info | text | password | select | cascade | check | radio]
• name: The name of the variable to store the resulting selection; **NOTE**: select, cascade and radio also store the value of the label as %VAR%_label
  sequence variables
• label: The label to display beside the field

info

• query: A WQL query as data source

text

• required: [ true | false] specifies if the field is mandatory
• default: a WQL query to provide a default value
• maxLength: the maximum allowed length of the field

password

• required: [ true | false] specifies if the field is mandatory

check

• checked: specifies if the field is checked by default

radio

• default: specifies the default selection
• options: a json object array of value/label pairs to define radio buttons

select

• options: a json object array of value/label pairs to define dropdown menu options

cascade

• dependsOn: The select field to base the selection options on
• options: an array of nested json object arrays with select values and sub options per dependent selection menu item

Example Settings File

{
    "__version__": "0.1.3",
    "width": 440,
    "height": 400,
    "rowheight": 25,
    "labelcolumnX": 10,
    "fieldcolumnX": 150,
    "rowy": 90,
    "textboxsize": 200,
    "title": "Build Prompt",
    "header": "",
    "footer": "Warning: This system is about to be rebuilt resulting in the loss of all data. If you DO NOT wish to proceed, immediately power off and remove any thumb drives.",
    "errorcolor": "#FFFF77",
    "headercolor": "#47154A",
    "fields": [{
            "type": "info",
            "name": "INFIPADDRESS",
            "label": "IP Address",
            "query": "SELECT IPAddress FROM Win32_NetworkAdapterConfiguration WHERE IPEnabled = True AND DHCPEnabled = True"
        },
        {
            "type": "text",
            "name": "OSDComputerName",
            "label": "Computer Name",
            "default": "SELECT SerialNumber FROM Win32_BIOS",
            "required": true,
            "maxLength": 15
        },
        {
            "type": "select",
            "name": "BUILD",
            "label": "Build",
            "options": {
                "standard": "Standard",
                "finance": "Finance",
                "casestudy": "Case Study"
            }
        },
        {
            "type": "password",
            "name": "PASSWORD",
            "label": "Password",
            "required": true
        },
        {
            "type": "check",
            "name": "OPTION1",
            "label": "Option 1?",
            "checked": true
        },
        {
            "type": "radio",
            "name": "REDIOEX",
            "label": "Radio Example",
            "default": "standard",
            "options": {
                "standard": "Standard",
                "finance": "Finance",
                "casestudy": "Case Study"
            }
        },
        {
            "type": "cascade",
            "name": "CASCADEEX",
            "label": "Cascade Example",
            "dependsOn": "BUILD",
            "options": {
                "Standard": {
                    "std1": "Std 1",
                    "std2": "Std 2",
                    "std3": "Std 3"
                },
                "Finance": {
                    "fin1": "Fin 1",
                    "fin2": "Fin 2",
                    "fin3": "Fin 3"
                },
                "CaseStudy": {
                    "cs1": "CS 1",
                    "cs2": "CS 2",
                    "cs3": "CS 3"
                }
            }
        }
    ]
}

Validation

Custom Validation

Example Custom Validation Script

Param(
    [string]$Value
)

$BadChars = @(
	"\",
	"/",
	":",
	"*",
	"?",
	"!",
	" ",
	"'",
	'"',
	"<",
	">",
	"|",
	"_",
	".",
	",",
	"~",
	"@",
	"#",
	"$",
	"%",
	"^",
	"&",
	"(",
	")",
	"{",
	"}"
)


$CharResult=$true
$Result=$True
$Buttons = [System.Windows.Forms.MessageBoxButtons]::OK
$Icon = [System.Windows.Forms.MessageBoxIcon]::Error # <-- Change to' Warning' to use as a 'warning' only prompt
$Title = "Error"


# Test for bad chars
$Value.tochararray() | ForEach-Object{If($_ -in $BadChars){$CharResult=$False}}
If($CharResult -eq $false){
    [System.Windows.Forms.MessageBox]::Show("The computer name cannot contain any of the following: $($BadChars -join ', ')",$Title,$Buttons,$Icon) | Out-Null
    $Result=$false # <-- Change to $true to use as a 'warning' only prompt
}

$Result

To-Do

• Add datafile validation