diff --git a/website/source/docs/boxes/base.html.md b/website/source/docs/boxes/base.html.md index e5f5a2bcd..cfeaf86be 100644 --- a/website/source/docs/boxes/base.html.md +++ b/website/source/docs/boxes/base.html.md @@ -178,12 +178,13 @@ can take many seconds. ## Windows Boxes Supported Windows guest operating systems: -- Windows 7 -- Windows 8 -- Windows Server 2008 -- Windows Server 2008 R2 -- Windows Server 2012 -- Windows Server 2012 R2 + + - Windows 7 + - Windows 8 + - Windows Server 2008 + - Windows Server 2008 R2 + - Windows Server 2012 + - Windows Server 2012 R2 Windows Server 2003 and Windows XP are _not_ supported, but if you are a die hard XP fan [this](https://stackoverflow.com/a/18593425/18475) may help you. @@ -236,6 +237,26 @@ netsh firewall add portopening TCP 5985 "Port 5985" winrm set winrm/config/listener?Address=*+Transport=HTTP @{Port="5985"} ``` +### Optional WinSSH Configuration + +When using the WinSSH communicator, you may run into an issue where a PowerShell +command can't display a progress bar. A typical error message might look like: + +``` +Win32 internal error "Access is denied" 0x5 occurred while reading the console output buffer. +``` + +In order to prevent this, we recommend setting `$ProgressPreference = "SilentlyContinue"` +in your box's PowerShell profile: + +``` +if (!(Test-Path -Path $PROFILE)) { + New-Item -ItemType File -Path $PROFILE -Force +} + +Add-Content $PROFILE '$ProgressPreference = "SilentlyContinue"' +``` + ## Other Software At this point, you have all the common software you absolutely _need_ for