{"id":4731,"date":"2009-01-10T18:16:00","date_gmt":"2009-01-10T18:16:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2009\/01\/10\/capture-console-screen\/"},"modified":"2019-02-18T13:12:55","modified_gmt":"2019-02-18T20:12:55","slug":"capture-console-screen","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/capture-console-screen\/","title":{"rendered":"Capture console screen"},"content":{"rendered":"

<\/p>\n

Seeing nicely formatted console examples in a previous post has inspired me to write a script that captures the console screen buffer directly from the Windows PowerShell console host. With this script you can make console "screen shots" to demonstrate some of your favorite Windows PowerShell concepts, and then post them to your blog, or put them on your Web site. <\/font><\/font><\/font><\/p>\n

How is it done? The console host has a powerful API that is somewhat neglected by most script writers. This API allows you to capture console screen rectangles or output a colorized text in arbitrary areas of the screen. The console API functions are available in Windows PowerShell as properties and methods of the $Host.UI and $Host.UI.RawUI objects. <\/font><\/font><\/font><\/p>\n

The script makes a good use of one of this methods \u2013 $Host.UI.RawUI.GetBufferContents. This method extracts a rectangular region of the screen buffer. We will use it to capture the console screen buffer contents from the top left corner to the current cursor position. <\/font><\/font><\/font><\/p>\n

Note that $Host.UI and $Host.UI.RawUI are fully supported only on Windows PowerShell console, the one that is started by running powershell.exe. Windows PowerShell ISE does not implement all of these interfaces and therefore cannot be used to run this script. <\/font><\/font><\/font><\/p>\n

To use the script, just open the Windows PowerShell console, run commands that you want to demonstrate, and then run this script to capture the console screen buffer.<\/font><\/font><\/font><\/p>\n

Windows PowerShell V2                                                                                                  <\/span>
Copyright (C) 2008 Microsoft Corporation. All rights reserved.                                                         <\/span>
                                                                                                                       <\/span>
PS C:\\Users\\Vladimir> cd E:\\MyScripts                                                                                  <\/span>
PS E:\\MyScripts> .\\RunMyCoolDemo.ps1                                                                                   <\/span>
                                                                                                                       <\/span>
Here are colors which you can use in Windows PowerShell console:                                                       <\/span>
                                                                                                                       <\/span>
   Black<\/span>                                                                                                               <\/span>
   DarkBlue<\/span>                                                                                                            <\/span>
   DarkGreen<\/span>                                                                                                           <\/span>
   DarkCyan<\/span>                                                                                                            <\/span>
   DarkRed<\/span>                                                                                                             <\/span>
   DarkMagenta<\/span>                                                                                                         <\/span>
   DarkYellow                                                                                                          <\/span>
   Gray<\/span>                                                                                                                <\/span>
   DarkGray<\/span>                                                                                                            <\/span>
   Blue<\/span>                                                                                                                <\/span>
   Green<\/span>                                                                                                               <\/span>
   Cyan<\/span>                                                                                                                <\/span>
   Red<\/span>                                                                                                                 <\/span>
   Magenta<\/span>                                                                                                             <\/span>
   Yellow<\/span>                                                                                                              <\/span>
   White<\/span>                                                                                                               <\/span>
                                                                                                                       <\/span>
Note that DarkMagenta and DarkYellow colors are redefined to produce these nice tints of white and blue which are used <\/span>
as default Foreground and Background colors.                                                                           <\/span>
                                                                                                                       <\/span>
PS E:\\MyScripts> $textFileName = "$env:temp\\ConsoleBuffer.txt"                                                         <\/span>
PS E:\\MyScripts> .\\Get-ConsoleAsText | out-file $textFileName -encoding ascii                                          <\/span>
PS E:\\MyScripts> $null = [System.Diagnostics.Process]::Start("$textFileName")                                          <\/span>
PS E:\\MyScripts>                                                                                                       <\/span>
<\/pre>\n
    <\/p>\n
 <\/p>\n
And don’t forget to walk through the code and see how it uses the System.Management.Automation.Host class. You might get some great ideas for your next project. <\/p>\n
 <\/p>\n
Enjoy! <\/p>\n
Vladimir Averkin <\/p>\n
Windows PowerShell Team<\/p>\n<\/p>\n
        <\/font><\/font><\/font><\/p>\n
#################################################################################################################<\/span>\n      
# Get-ConsoleAsText.ps1<\/span>\n      
#<\/span>\n      
# The script captures console screen buffer up to the current cursor position and returns it in plain text format.<\/span>\n      
#<\/span>\n      
# Returns: ASCII-encoded string.<\/span>\n      
#<\/span>\n      
# Example:<\/span>\n      
#<\/span>\n      
# $textFileName = "$env:temp\\ConsoleBuffer.txt"<\/span>\n      
# .\\Get-ConsoleAsText | out-file $textFileName -encoding ascii<\/span>\n      
# $null = [System.Diagnostics.Process]::Start("$textFileName")<\/span>\n      
#<\/span><\/p>\n
# Check the host name and exit if the host is not the Windows PowerShell console host.<\/span>\n      
if<\/span> <\/span>(<\/span>$host<\/span>.<\/span>Name<\/span> <\/span>-ne<\/span> <\/span>‘ConsoleHost’<\/span>)<\/span>\n      
{<\/span>\n      
  <\/span>write-host<\/span> <\/span>-ForegroundColor<\/span> <\/span>Red<\/span> <\/span>"This script runs only in the console host. You cannot run this script in $($host.Name)."<\/span>\n      
  <\/span>exit<\/span> <\/span>-1<\/span>\n      
}<\/span><\/p>\n
# Initialize string builder.<\/span>\n      
$textBuilder<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>system.text.stringbuilder<\/span><\/p>\n
# Grab the console screen buffer contents using the Host console API.<\/span>\n      
$bufferWidth<\/span> <\/span>=<\/span> <\/span>$host<\/span>.<\/span>ui<\/span>.<\/span>rawui<\/span>.<\/span>BufferSize<\/span>.<\/span>Width<\/span>\n      
$bufferHeight<\/span> <\/span>=<\/span> <\/span>$host<\/span>.<\/span>ui<\/span>.<\/span>rawui<\/span>.<\/span>CursorPosition<\/span>.<\/span>Y<\/span>\n      
$rec<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>System.Management.Automation.Host.Rectangle<\/span> <\/span>0<\/span>,<\/span>0<\/span>,<\/span>(<\/span>$bufferWidth<\/span> <\/span>–<\/span> <\/span>1<\/span>)<\/span>,<\/span>$bufferHeight<\/span>\n      
$buffer<\/span> <\/span>=<\/span> <\/span>$host<\/span>.<\/span>ui<\/span>.<\/span>rawui<\/span>.<\/span>GetBufferContents<\/span>(<\/span>$rec<\/span>)<\/span><\/p>\n
# Iterate through the lines in the console buffer.<\/span>\n      
for<\/span>(<\/span>$i<\/span> <\/span>=<\/span> <\/span>0<\/span>;<\/span> <\/span>$i<\/span> <\/span>-lt<\/span> <\/span>$bufferHeight<\/span>;<\/span> <\/span>$i<\/span>++<\/span>)<\/span>\n      
{<\/span>\n      
  <\/span>for<\/span>(<\/span>$j<\/span> <\/span>=<\/span> <\/span>0<\/span>;<\/span> <\/span>$j<\/span> <\/span>-lt<\/span> <\/span>$bufferWidth<\/span>;<\/span> <\/span>$j<\/span>++<\/span>)<\/span>\n      
  <\/span>{<\/span>\n      
    <\/span>$cell<\/span> <\/span>=<\/span> <\/span>$buffer<\/span>[<\/span>$i<\/span>,<\/span>$j<\/span>]<\/span>\n      
    <\/span>$null<\/span> <\/span>=<\/span> <\/span>$textBuilder<\/span>.<\/span>Append<\/span>(<\/span>$cell<\/span>.<\/span>Character<\/span>)<\/span>\n      
  <\/span>}<\/span>\n      
  <\/span>$null<\/span> <\/span>=<\/span> <\/span>$textBuilder<\/span>.<\/span>Append<\/span>(<\/span>"`r`n"<\/span>)<\/span>\n      
}<\/span><\/p>\n
return<\/span> <\/span>$textBuilder<\/span>.<\/span>ToString<\/span>(<\/span>)<\/span>\n      <\/p>\n
  <\/font><\/font><\/p>\n","protected":false},"excerpt":{"rendered":"
Seeing nicely formatted console examples in a previous post has inspired me to write a script that captures the console screen buffer directly from the Windows PowerShell console host. With this script you can make console "screen shots" to demonstrate some of your favorite Windows PowerShell concepts, and then post them to your blog, or […]<\/p>\n","protected":false},"author":600,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[131,196],"class_list":["post-4731","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell","tag-console","tag-host"],"acf":[],"blog_post_summary":"
Seeing nicely formatted console examples in a previous post has inspired me to write a script that captures the console screen buffer directly from the Windows PowerShell console host. With this script you can make console "screen shots" to demonstrate some of your favorite Windows PowerShell concepts, and then post them to your blog, or […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/4731","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/users\/600"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=4731"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/4731\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media\/13641"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media?parent=4731"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=4731"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=4731"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}