This project is now part of

Special Thanks to Adam Driscoll for helping write this script.

This is a powershell script that utilizes the the Open Source project FreeRDP's wfreerdp.exe.

This was put together because the Free Core server 2012 does not come with a vmconnect.exe. What vmconnect.exe does is allow you to RDP to a brand new VM that does not have an IP yet. How it works is, first it connects to your localhost on port 2179 and then redirects you to the VMID (GUID) of the VM you are wanting to connect too.
FreeRDP has written wfreerdp.exe which allows you to do just as described above. If you are wondering regular MSTSC.exe allows you to redirect to a new port and uses the RDP protocol but that is where the similarities end.

This powershell script will find all your VM's and then asks you which one you would like to connect too. You input the number beside the VM and it will see if it can connect with an IP, if not it will connect via the VMID. (where Test is the server you name you chose)
It then displays: Connecting to Test - (if connecting via IP)
or it displays: Connecting to Test - abdf-dhggsh0011-20021 (if connecting via VMID)

If connecting via IP you input the local Administrator acct and password.
If connecting via VMID you must authenticate the the local VHOST, input the localhost server Administrator acct and password.

NOTE: If you know for a fact the VM has a IP address but it keeps connecting via the VMID. To fix this install the lastest Misrcosoft integration Tools package on the VM.

This works with linux distro Ubuntu (been tested) and it will connect to the VMID but if you want it to connect to the IP address of the Linux VM you need to install XRPD on the linux VM.

Visit my blog at

Last edited Aug 9, 2013 at 9:04 PM by James_Stephan, version 9