Latest Version
1.08, 9th September 2013.
Note: There are no plans add support for Windows 10/Windows Server 2016 - there are too many changes in Windows 10 to take this on in a simple manner right now given other things I'm working on. Sorry.
About
- HVRemote reduces the manual configuration steps needed for Hyper-V Remote Management down to a few simple commands.
- HVRemote can diagnose common configuration errors.
- HVRemote is locale neutral, although output is in English only.
- HVRemote can configure all combinations of workgroup and domain joined clients and servers.
If you find HVRemote useful, please drop me an email through my blog, add a comment to this post, or provide a rating above ^^^. Thank you! :)
10-second guide
| Configuration | Where | Purpose | Commands |
|---|---|---|---|
| Client and Server both workgroup | Server | Create a local account (eg "john") | Use net user /? or Computer Management |
| Server | Grant the user access | hvremote /add:accountname *** | |
| Client | Allow Anonymous Logon remote DCOM access | hvremote /anondcom:grant | |
| Client | Logon with matching local account. | ||
| Client | If passwords do not match | cmdkey /add:servername /user:servername\account /pass | |
| Both | Verify configuration for errors | hvremote /show /target:othercomputername | |
| ------------------------- | |||
| Client workgroup, Server domain | Server | Grant domain account access | hvremote /add:domain\account *** |
| Client | Allow Anonymous Logon remote DCOM access | hvremote /anondcom:grant | |
| Client | Set credentials for domain account | cmdkey /add:servername /user:domain\account /pass | |
| Both | Verify configuration for errors | hvremote /show /target:othercomputername | |
| ------------------------- | |||
| Client domain, Server workgroup | Server | Create a local account (eg "john") | Use net user /? or Computer Management |
| Server | Grant the user access | hvremote /add:accountname *** | |
| Client | Allow Anonymous Logon remote DCOM access | hvremote /anondcom:grant | |
| Client | Set credentials for local account | cmdkey /add:servername /user:servername\accountname /pass | |
| Both | Verify configuration for errors | hvremote /show /target:othercomputername | |
| ------------------------- | |||
| Client and Server both domain | Server | Grant the non-admin user access | hvremote /add:domain\account *** |
| Both | Verify configuration for errors | hvremote /show /target:othercomputername |
*** Restart server if this is the first time an account has been added. Not required for Windows 8 Client Hyper-V or Windows Server 2012 and later operating systems
Supported Servers:
-
- Windows Server 2008 SP1 with Hyper-V RTM update applied (KB950050), Core & Full installations
- Windows Server 2008 SP2, Core & Full installations
- Microsoft Hyper-V Server 2008 SP1 (already contains Hyper-V RTM update)
- Microsoft Hyper-V Server 2008 SP2
- Windows Server 2008 R2, Core & Full installations
- Windows Server 2008 R2 SP1, Core & Full installations
- Microsoft Hyper-V Server 2008 R2
- Microsoft Hyper-V Server 2008 R2 SP1
- Windows Server 2012 Core & Full installations (Version 1.x or later)
- Microsoft Hyper-V Server 2012 (Version 1.x or later)
- Windows 8 Pro & Enterprise x64 with Hyper-V enabled (Version 1.x or later)
- Windows Server 2012 R2 Core & Full installations (Version 1.08 or later)
- Microsoft Hyper-V Server 2012 R2 (Version 1.08 or later)
- Windows 8.1 x64 Client Hyper-V (Version 1.08 or later)
Supported Clients:
- Windows Vista Business, Enterprise and Ultimate x86 & x64, SP1 and SP2, with KB952627 applied
- Windows 7 Professional, Enterprise and Ultimate x86 & x64 with RSAT installed and Hyper-V tools feature enabled
- Windows 8 Pro and Enterprise x86 and x64 with Hyper-V Management Tools feature enabled (Version 1.x or later)
- Windows 8.1 Pro and Enterprise x86 and x64 with Hyper-V Management Tools feature enabled (Version 1.08 or later)
- Windows Server 2008 SP1 with Hyper-V RTM update applied (KB950050), x86 and x64
- Windows Server 2008 SP2 x86 and x64
- Windows Server 2008 R2
- Windows Server 2008 R2 SP1
- Windows Server 2012 (Version 1.x or later)
- Windows Server 2012 R2 (Version 1.08 or later)
Command summary
Please see the documentation for more information - below is not a complete list of all command line options, just the most commonly needed commands. Commands should be run from an elevated command prompt.
If the default scripting engine is already CScript, you can run each command exactly as shown in the table. To change the default scripting engine to cscript, run
cscript //h:cscript. Alternately, launch each command using the longer format:
cscript hvremote.wsf
command
| Applicability | Operation | Command |
|---|---|---|
| Server | Grant account access | hvremote /add:domain\account (Domain) or hvremote /add:account (Workgroup) |
| Server | Revoke account access | hvremote /add:domain\account (Domain) or hvremote /add:account (Workgroup) |
| Both | Display settings | hvremote /show |
| Client | Display settings and test server connectivity | hvremote /show /target:servercomputername |
| Server | Display settings and test client connectivity | hvremote /show /target:clientcomputername |
| Both | Display help | hvremote /? |
| Client | Permit ANONYMOUS LOGON remote DCOM access | hvremote /AnonDCOM:grant |
| Client | Deny ANONYMOUS LOGON remote DCOM access | hvremote /AnonDCOM:revoke |
Installation & Removal
Save HVRemote.wsf to a directory on the local disk (eg c:\HVRemote). There is no setup program, it is run from a elevated command prompt. To uninstall, simply delete the file.
General Usage
It is easier if you change the scripting engine to cscript by running "cscript //H:cscript" before use. Should you not wish to do this, instead of running "hvremote Operation [Options]", run "cscript hvremote.wsf Operation [Options]"
Known Issues
HVRemote has not been verified using Microsoft accounts in Windows 8 and later, only local and domain accounts
Disclaimer
Although I work for Microsoft and am a Program Manager in the Hyper-V team, I must point you to the disclaimer on my
blog, the disclaimer in the documentation, and the license conditions at the top of this page before use. HVRemote and the associated documentation are provided "as-is". You bear the risk
of using it. No express warranties, guarantees or conditions are provided. It is not supported or endorsed by Microsoft Corporation and should be used at your own risk.
Thanks,
John.