- RyanTAdams.com - //blog.ryantadams.com -

Virtual PC 2007 Command Line Options

Virtual PC.exe is the Virtual PC command-line utility and can be used to perform a variety of Virtual PC and virtual machine tasks. By default, it is located in \Program Files\Microsoft Virtual PC. The following is a list of all supported command line options for Virtual PC 2007.


Syntax:

“Virtual PC.exe”[-singlepc] [-quiet][-usehostdiskcache][-pc virtual_machine_name [[-disableclose][-disableopt][-s3bitclip][-setbiosno bios_serial_number][-setassettag asset_tag] [-extnetworking]-launch] [{-fullscreen|-window}][-geometry widthxheight{+|-}x offset{+|-}y offset][{-minimize|-restore}][{-pause|-resume}]][-help][-registervm filename.vmc][-startvm filename.vmc] 

Parameters:

Command-line arguments are case-sensitive, but the parameters passed to these commands are not case-sensitive.

-singlepc Starts the specified virtual machine without starting Virtual PC Console. This parameter can be useful for simplifying the Virtual PC interface in a corporate or lab environment, where users only want to access a virtual machine and do not need access to Virtual PC Console. This parameter can be used only when starting Virtual PC.
-quiet Prevents the starting of any virtual machines that are configured to start automatically. This parameter can be used only when starting Virtual PC.
-usehostdiskcache Turns on host-side disk caching, which can improve performance of virtual machines running operating systems other than Windows. This parameter can be useful for resolving poor performance problems with disk intensive tasks. This parameter can be used only when starting Virtual PC.
-registervm filename.vmc Registers the specified .vmc file, which adds the corresponding virtual machine to the list of virtual machines. This parameter can be useful for using an automated deployment to register a .vmc without launching it. This parameter can be used only when the virtual machine is not running. An absolute path to the .vmc file is required.
-startvm filename.vmc Registers the specified .vmc file, which adds the corresponding virtual machine to the list of virtual machines, and starts the virtual machine. This parameter can be used only when starting the virtual machine. An absolute path to the .vmc file is required
-pc virtual_machine_name Performs operations on a specific virtual machine. The virtual_machine_name is the name that appears in Virtual PC Console and the virtual machine window for the virtual machine. The virtual_machine_name is case-sensitive. The following table describes the options for this parameter.

Value

Description
-disableclose Disables the Close button on the specified virtual machine. This parameter can be used only when starting the virtual machine.
-disableopt Disables any direct mode execution within the specified virtual machine. This parameter can be useful for providing a temporary resolution for poor stability of applications on a guest operating system. This parameter can be used only when starting the virtual machine.
-s3bitclip Clips accelerated S3 bit coordinates to 12 bits on the specified virtual machine. This parameter can be used only when starting the virtual machine.
-setbiosno bios_serial_number Sets the BIOS serial number of the specified virtual machine to the value specified. This can be useful for tracking Virtual PCs when using hardware management software. This parameter can be used only when starting the virtual machine.
-setassettag asset_tag Sets the chassis asset tag of the specified virtual machine to the value specified. This can be useful for tracking Virtual PCs when using hardware management software or tracking other specific information. This parameter can be used only when starting the virtual machine.
-extnetworking Specifies that all network connections on the specified virtual machine operate in external only mode. This limits the access of the virtual machine to only resources external to the physical computer. This parameter can be used only when starting the virtual machine. This parameter does not affect the network connections of the virtual machines that are configured to use shared networking.
-launch Starts the specified virtual machine. Specify this parameter after -pc and any other optional parameters shown before -launch in the syntax section.
-fullscreen Switches a running virtual machine to full-screen mode. This parameter can be used only when the virtual machine is running.
-window Switches a virtual machine running in full-screen mode to window mode. This parameter can be used only when the virtual machine is running.
-geometry widthxheight{+|}x offset{+|}y offset Specifies the location and window size of the specified virtual machine. The offsets are relative to the upper left corner of the screen. Use of x offset and y offset is optional. This parameter can be used only when the virtual machine is running.
-minimize Minimizes the specified virtual machine. This parameter can be used only when the virtual machine is running.
-restore Brings the specified virtual machine to the foreground of the screen. This parameter can be used only when the virtual machine is running.
-pause Pauses the specified virtual machine. This parameter can be used only when the virtual machine is running.
-resume Restores a paused virtual machine to an active state. This parameter can be used only when the virtual machine is running.