Change the PowerShell console size and state programmatically

Being able to change the size of the console window (or any window for that matter) are quick and easy to do using the mouse. The same for changing the window state (for example maximizing a window). But if you want to do this programmatically (for whatever reason) it’s not so simple.

I have created a small function that makes this much easier to accomplish.

The main function (Resize-Console) lets you set a custom Width and Height for the console window, as well as maximize the console, or restore it if it’s already maximized. Note that the custom size only works in a console window, so if you try this in PowerShell ISE it will give you a warning and abort.

The maximize and restore functionality on the other hand, works in both the console and in ISE.

I have also included a couple of small helper functions. The first, Get-ConsoleSize, will just output the current size of the console window, while Get-WindowState will return either ‘Normal‘ or ‘Maximized‘ based on the current state of the window.

As always, holler if you spot any bugs, or have suggestions for future improvements.

function Resize-Console {
Resize the PowerShell console programmatically.
This function lets you resize the PowerShell console window by setting
custom width and height properties, as well as maximize and restore the
console window.
Resize-Console 200 50
Resize-Console -Maximize
Resize-Console -Restore
if (Get-WindowState -eq 'Normal') {Resize-Console -Maximize}
Author: Øyvind Kallstad
Date: 11.10.2015
Version: 1.0
[CmdletBinding(DefaultParameterSetName = 'CustomSize')]
param (
# Set the window width.
[Parameter(ParameterSetName = 'CustomSize', Position = 0)]
[int] $Width = $host.UI.RawUI.WindowSize.Width,
# Set the window height.
[Parameter(ParameterSetName = 'CustomSize', Position = 1)]
[int] $Height = $host.UI.RawUI.WindowSize.Height,
# Maximize the window.
[Parameter(ParameterSetName = 'Maximize')]
[switch] $Maximize,
# Restore the window (if maximized).
[Parameter(ParameterSetName = 'Restore')]
[switch] $Restore
if(($PSCmdlet.ParameterSetName -eq 'Maximize') -or ($PSCmdlet.ParameterSetName -eq 'Restore')) {
$Win32ShowWindowAsync = Add-Type –memberDefinition @”
public static extern bool ShowWindowAsync(IntPtr hWnd, int nCmdShow);
“@ name 'Win32ShowWindowAsync' namespace Win32Functions –passThru
# get main window handle of the current process
$MainWindowHandle = (Get-Process –id $pid).MainWindowHandle
if ($Maximize) {
$Win32ShowWindowAsync::ShowWindowAsync($MainWindowHandle, 3) | Out-Null
if ($Restore) {
$Win32ShowWindowAsync::ShowWindowAsync($MainWindowHandle, 9) | Out-Null
else {
if ($host.Name -eq 'ConsoleHost') {
# buffer size can't be smaller than window size
if ($Width -gt $host.UI.RawUI.BufferSize.Width) {
$host.UI.RawUI.BufferSize = New-Object TypeName System.Management.Automation.Host.Size ArgumentList ($Width, $host.UI.RawUI.BufferSize.Height)
# if width is too large, set to max allowed size
if ($Width -gt $host.UI.RawUI.MaxPhysicalWindowSize.Width) {
$Width = $host.UI.RawUI.MaxPhysicalWindowSize.Width
# if height is too large, set to max allowed size
if ($Height -gt $host.UI.RawUI.MaxPhysicalWindowSize.Height) {
$Height = $host.UI.RawUI.MaxPhysicalWindowSize.Height
# set window size
$host.UI.RawUI.WindowSize = New-Object TypeName System.Management.Automation.Host.Size ArgumentList ($Width, $Height)
else {
Write-Warning 'Setting the console window size is only supported when running in the console host.'
function Get-ConsoleSize {
Write-Output ($host.UI.RawUI.WindowSize)
function Get-WindowState {
$Win32IsZoomed = Add-Type –memberDefinition @”
public static extern bool IsZoomed(IntPtr hWnd);
“@ name 'Win32IsZoomed' namespace Win32Functions –passThru
if ($Win32IsZoomed::IsZoomed(((Get-Process id $pid).MainWindowHandle))) {
Write-Output 'Maximized'
else {
Write-Output 'Normal'

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s