{"id":6308,"date":"2018-12-20T16:18:53","date_gmt":"2018-12-20T21:18:53","guid":{"rendered":"https:\/\/jdhitsolutions.com\/blog\/?p=6308"},"modified":"2018-12-20T16:18:59","modified_gmt":"2018-12-20T21:18:59","slug":"ultimate-powershell-telemetry-prompt","status":"publish","type":"post","link":"https:\/\/jdhitsolutions.com\/blog\/powershell\/6308\/ultimate-powershell-telemetry-prompt\/","title":{"rendered":"The Ultimate PowerShell Telemetry Prompt"},"content":{"rendered":"

Well, I knew I wouldn't be satisfied. The other day I shared a PowerShell prompt function that could display telemetry like information<\/a> for a few remote servers. One of the drawbacks was the limited amount of information I could display. I've revised that function and have a new version that displays additional information via a few performance counters. I've also reorganized the function to make it a bit more efficient. Want to see it?<\/p>\n

<\/p>\n

Enhanced Display<\/h1>\n

This version still reads a list of computer names. I'd still recommend keeping this list brief. Although I have modified the prompt display so that each server has its own line.<\/p>\n

\"an<\/a><\/p>\n

This version of the function calls Get-Counter to retrieve additional information.<\/p>\n

#define a list of performance counters    \n$c = \"\\processor(_total)\\% processor time\",\n\"\\physicaldisk(_total)\\% disk time\",\n\"\\server\\bytes total\/sec\",\n\"\\system\\file control operations\/sec\" \n\n\n#create a hashtable of counters and values\nget-counter -Counter $c | select-object -ExpandProperty countersamples |\n    foreach-object -Begin {$counterhash = @{}} -process {\n    $counterHash.add($_.Path.split(\"\\\\\")[-1], [math]::round($_.CookedValue, 2))\n}\n<\/pre>\n
The counter data is added to the output for each server.<\/p>\n
\"annotated<\/a><\/p>\n
For visual interest, I'm using a hashtable of character values. The tricky part was padding values to get everything to line up. Even so, there may be instances where data doesn't completely line up. This generally resolves itself the next time you refresh.<\/p>\n
Creating a One Command Session<\/h1>\n
I also am trying something new with this prompt. When you run a command, PowerShell wants to automatically invoke the prompt function. I inserted a Pause command (which only works on Windows). When you press Enter, the screen is cleared and you get your monitoring display at the top of the PowerShell console.<\/p>\n
\"Displaying<\/a><\/p>\n
If you are only using the PowerShell console to occasionally run a command or merely want to periodically refresh the data, this might be useful. However, you can toggle this feature. When you load the prompt, PowerShell will define a global variable called PromptClear with a value of $True. Run $PromptClear = $False to turn off the pause and clear. Set it back to $True to turn it back on.<\/p>\n
Get the PowerShell Code<\/h1>\n
By now some of you are chomping to give this a shot. The file is hosted on GitHub<\/a>.<\/p>\n