Get-BluGenieTrapData

﻿
Get-BluGenieTrapData
SYNOPSIS
Get-BluGenieTrapData will report back any captured BluGenie trap logs.
Functions as follows
List - Display a list of all the Blugenie Logs captured on the remote machine
Path - Specificy a path to query for Blugenie Logs (By defautl this is %SystemDrive%\Windows\Temp)
FileName - Specifically select which file you want to report on (By default the last file created is picked). The file name can be picked using RegEx.
JobID - Specify which file you want to remote on using the Job ID (Be default this is the last log created with the Job ID specified. You can have more then one log with the same Job ID)
Remove - Remove a Specific log file
RemoveAll - Remove BluGenie log files including the Debugging Log files
Overwrite - Return the current JSON Job data to look just like the Trapped Log data for easier reporting and parsing
SYNTAX
Get-BluGenieTrapData [[-Path] <String>] [[-FileName] <String>] [-JobID <String>] [-List] [-Remove] [-RemoveAll] [-OverWrite] [-Walkthrough] [-ReturnObject] [-OutUnEscapedJSON] [-FormatView <String>] 
[<CommonParameters>]
DESCRIPTION
Invoke-WalkThrough is Dynamic Help. It will convert the static PowerShell help into an interactive menu system -Added with a few new tag descriptors for (Parameter and Examples). This information will structure the help information displayed and also help with bulding the dynamic help menu
EXAMPLES
EXAMPLE 1
Command: Get-BluGenieTrapData -List
Description: List all BluGenie log files from the default location $ENV:SystemDrive\Windows\Temp
Notes:
EXAMPLE 2
Command: Get-TrapData -path '\\win7sp1001\c$\Windows\Temp' -ReturnObject -List
Description: List all BluGenie log files from a remote systems log location.  Return on the Name, File Size, and LastWriteTime
Notes:
EXAMPLE 3
Command: Get-BluGenieTrapData
Description: Return the last written log file from the default log location
Notes:
EXAMPLE 4
Command: Get-BluGenieTrapData -path '\\win7sp1001\c$\Windows\Temp' -ReturnObject -Remove
Description: Return the last written log file data in an object format and, remove the file from disk
Notes:
EXAMPLE 5
Command: Get-BluGenieTrapData -Remove -List
Description: Remove all items that are found
Notes:
EXAMPLE 6
Command: Get-BluGenieTrapData -RemoveAll -List
Description: Remove all items that are found
Notes:
EXAMPLE 7
Command: Get-BluGenieTrapData -path '\\win7sp1001\c$\Windows\Temp' -Remove
Description: Remove the file on disk after grabbing the trapped data
Notes:
EXAMPLE 8
Command: Get-BluGenieTrapData -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: Get-BluGenieTrapData -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
EXAMPLE 10
Command: Get-BluGenieTrapData -OutUnEscapedJSON
Description: <command_here> and Return Output as UnEscaped JSON format
Notes:  The OutUnEscapedJSON is used to beatify the JSON return and not Escape any Characters.  Normal return data is a Hash Table.
EXAMPLE 11
Command: Get-BluGenieTrapData -ReturnObject
Description: <command_here> and Return Output an Object
Notes:  The ReturnObject is used to return a PowerShell Object.  Normal return data is a Hash Table.
PARAMETERS
Path
-Path <String>
   Description:  Path to the BG*.log files.
   Notes: Default is set to $ENV:Systemdrive\Windows\Temp
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    1
   Default value                $('{0}\Windows\Temp' -f $env:SystemDrive)
   Accept pipeline input?       false
   Accept wildcard characters?  false
FileName
-FileName <String>
   Description:  Specify which file to pull
   Notes:  You can determine what log files are saved using the -List parameter
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    2
   Default value                
   Accept pipeline input?       false
   Accept wildcard characters?  false
JobID
-JobID <String>
   Description:  Specify the Job ID
   Notes:  The last file created with the Job ID specified will be the information returned
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                
   Accept pipeline input?       false
   Accept wildcard characters?  false
List
-List [<SwitchParameter>]
   Description:  List all the BG*.log files
   Notes:  You can return just file File Names, LastWriteTime, and Size by using the -ReturnObject parameter
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
Remove
-Remove [<SwitchParameter>]
   Description:  Remove the file specified or the last know log file found
   Notes:  
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
RemoveAll
-RemoveAll [<SwitchParameter>]
   Description:  Remove all BG*.log files
   Notes:  
   Alias:
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
OverWrite
-OverWrite [<SwitchParameter>]
   Description:  Flag used to return the Trapped data as the original return in BluGenie
   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
ReturnObject
-ReturnObject [<SwitchParameter>]
   Description: Return information as an Object
   Notes: By default the data is returned as a Hash Table
   Alias: 
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
OutUnEscapedJSON
-OutUnEscapedJSON [<SwitchParameter>]
   Description: Remove UnEsacped Char from the JSON information.
   Notes: This will beautify json and clean up the formatting.
   Alias: 
   ValidateSet:
   
   Required?                    false
   Position?                    named
   Default value                False
   Accept pipeline input?       false
   Accept wildcard characters?  false
FormatView
-FormatView <String>
   
   Required?                    false
   Position?                    named
   Default value                None
   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.
Get-BluGenieTranscriptsFile
Get-BluGenieWindowsTitle
Last modified 1yr ago