Manual
Search…
⌃K

Write BluGenieVerboseMsg



Write-BluGenieVerboseMsg

SYNOPSIS

Write-BluGenieVerboseMsg is used to display Time Stamped, Verbose Messages to the screen

SYNTAX

Write-BluGenieVerboseMsg [[-Message] <String>] [-Color <String>] [-Status <String>] [-CheckFlag <String>] [-ClearTimers] [-Walkthrough] [<CommonParameters>]

DESCRIPTION

Write-BluGenieVerboseMsg is used to display Time Stamped, Verbose Messages to the screen
You can view overall progress, elapsed time from one message to the next, change color and even check for an existing flag before displaying the message.

EXAMPLES

EXAMPLE 1

Command: $null = Write-BluGenieVerboseMsg -ClearTimers
Description: Clear global tracking time stamps
Notes: If you don't pass it to $null you will get a $true/$false when the process has ran

EXAMPLE 2

Command: Write-BluGenieVerboseMsg -Message "Starting" -Color 'Yellow' -Status 'StartTimer' -CheckFlag MyVerboseParam
Description: Setup the 1st overall message and timestamp with a message in Yellow, only if MyVerboseParam variable either (Exists or is $true)
Notes: If -CheckFlag is used the variable name (not the variable - no dollar sign) needs to be set. If the variable is true or exists the message will show,
if the variable is either false or doesn't exists the message will not show

EXAMPLE 3

Command: Write-BluGenieVerboseMsg -Msg "Running a Sub Task" -Color 'Cyan' -Status 'StartTask'
Description: Start a new timestamp track, with a message in Cyan
Notes:

EXAMPLE 4

Command: Write-BluGenieVerboseMsg -Msg "Just another message" -Color 'White' -Status '....'
Description: Send a generic message in White, elasped time is based on the last StartTask Timestamp
Notes:

EXAMPLE 5

Command: Write-BluGenieVerboseMsg -Msg "Just another message 2" -Color 'White' -Status '....'
Description: Send a 2nd generic message in White, elasped time is based on the last StartTask Timestamp
Notes:

EXAMPLE 6

Command: Write-BluGenieVerboseMsg -Message "Stopping Sub Task" -Color 'Yellow' -Status 'StopTask'
Description: Stop and Reset the timestamp block, and display a message in Yellow
Notes:

EXAMPLE 7

Command: Write-BluGenieVerboseMsg -Msg "Stopping" -Color 'Yellow' -Status 'StopTimer' -CheckFlag MyVerboseParam
Description: Stop and Reset the timestamp block, remove all global time stamps, and display a message in Yellow, only if MyVerboseParam variable either (Exists or is $true)
Notes: If -CheckFlag is used the variable name (not the variable - no dollar sign) needs to be set. If the variable is true or exists the message will show,
if the variable is either false or doesn't exists the message will not show

EXAMPLE 8

Command: Write-BluGenieVerboseMsg -Help
Description: Call Help Information
Notes: If Help / WalkThrough is setup as a parameter, this script will be called to setup the Dynamic Help Menu if not the normal Get-Help will be called with the -Full parameter

EXAMPLE 9

Command: Write-BluGenieVerboseMsg -WalkThrough
Description: Call Help Information [2]
Notes: If Help / WalkThrough is setup as a parameter, this script will be called to setup the Dynamic Help Menu if not the normal Get-Help will be called with the -Full parameter

PARAMETERS

Message

-Message <String>
Description: Message to display
Notes:
Alias: Msg
ValidateSet:
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false

Color

-Color <String>
Description: Select the Color of the output
Notes: Default value is ( White )
Alias:
ValidateSet: 'Black','Blue','Cyan','DarkBlue','DarkCyan','DarkGray','DarkGreen','DarkMagenta','DarkRed','DarkYellow','Gray','Green','Magenta','Red','White','Yellow'
Required? false
Position? named
Default value White
Accept pipeline input? false
Accept wildcard characters? false

Status

-Status <String>
Description: Set the type of Message
Notes: The elapsed time from one message to another depends on what Status type you select. The default value is '....' for generic, continued messaging
Alias:
ValidateSet: 'StopTimer','StartTimer','....','StartTask','StopTask'
Required? false
Position? named
Default value ....
Accept pipeline input? false
Accept wildcard characters? false

CheckFlag

-CheckFlag <String>
Description: CheckFlag will allow you to check to see if another variable is either True/False or Exists/Not Exists.
Notes: This will allow you to show messages based on another set action.
Alias:
ValidateSet:
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

ClearTimers

-ClearTimers [<SwitchParameter>]
Description: Clear the global tracking time stamps
Notes:
Alias:
ValidateSet:
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false

Walkthrough

-Walkthrough [<SwitchParameter>]
Description: Start the dynamic help menu system to help walk through the current command and all of the parameters
Notes:
Alias: Help
ValidateSet:
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.