show-dialogbox

SYNOPSIS
    Display a custom dialog box with optional title, buttons, icon and timeout.
    Show-InstallationPrompt is recommended over this function as it provides more customization and uses consistent branding with the other UI components.
SYNTAX
    Show-DialogBox [-Text] <String> [-Title <String>] [-Buttons <String>] [-DefaultButton <String>] [-Icon <String>] [-Timeout <String>] [-TopMost <Boolean>] [<CommonParameters>]
DESCRIPTION
    Display a custom dialog box with optional title, buttons, icon and timeout. The default button is "OK", the default Icon is "None", and the default Timeout is none.
PARAMETERS
    -Text <String>
        Text in the message dialog box
    -Title <String>
        Title of the message dialog box
    -Buttons <String>
        Buttons to be included on the dialog box. Options: OK, OKCancel, AbortRetryIgnore, YesNoCancel, YesNo, RetryCancel, CancelTryAgainContinue. Default: OK.
    -DefaultButton <String>
        The Default button that is selected. Options: First, Second, Third. Default: First.
    -Icon <String>
        Icon to display on the dialog box. Options: None, Stop, Question, Exclamation, Information. Default: None.
    -Timeout <String>
        Timeout period in seconds before automatically closing the dialog box with the return message "Timeout". Default: UI timeout value set in the config XML file.
    -TopMost <Boolean>
        Specifies whether the message box is a system modal message box and appears in a topmost window. Default: $true.
    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer, PipelineVariable, and OutVariable. For more information, see 
        about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216). 
    -------------------------- EXAMPLE 1 --------------------------
    PS C:\>Show-DialogBox -Title 'Installed Complete' -Text 'Installation has completed. Please click OK and restart your computer.' -Icon 'Information'
    -------------------------- EXAMPLE 2 --------------------------
    PS C:\>Show-DialogBox -Title 'Installation Notice' -Text 'Installation will take approximately 30 minutes. Do you wish to proceed?' -Buttons 'OKCancel' -DefaultButton 'Second' -Icon 
    'Exclamation' -Timeout 600 -Topmost $false
REMARKS
    To see the examples, type: "get-help Show-DialogBox -examples".
    For more information, type: "get-help Show-DialogBox -detailed".
    For technical information, type: "get-help Show-DialogBox -full".
    For online help, type: "get-help Show-DialogBox -online"