This section includes information that will help you to get started with VEShell.
Installing Veeam Virtualization Extensions Shell
VEShell is a component installed as part of the Veeam Virtualization Extensions Service on any machine that meets the system requirements.
Before installing Veeam Virtualization Extensions Service, make sure that Microsoft Windows PowerShell 2.0 or later is installed on the target machine. To download Microsoft Windows PowerShell 2.0, use the following link: http://support.microsoft.com/kb/968929.
Launching Veeam Virtualization Extensions Shell
To launch VEShell, select Veeam Virtualization Extensions Shell in the Start menu.
You can also import the VEShell into Windows PowerShell:
- Launch Windows PowerShell command prompt.
- Import the VEShell module by using the following command:
If the VEShell module installation fails with an error, this means that the Windows PowerShell script execution policy does not allow the module to be installed on your computer. In this case, change the execution policy to RemoteSigned. After the module is imported, you can set the execution policy back to Allsigned.
For more information on Windows PowerShell execution policies, see this Microsoft article.
Connecting to Veeam Virtualization Extensions Service
When you execute a command, VEShell connects to the Veeam Virtualization Extensions Service and performs the necessary configuration or management operation. You can work with Veeam Virtualization Extensions Service running on the localhost (that is, on the same machine where VEShell is installed) or with Veeam Virtualization Extensions Service running on any remote machine.
Most VEShell cmdlets support an optional -VESServer parameter. This parameter tells where the Virtualization Extensions Service is running and what options (port number, credentials) should be used for connecting to it. By default, if the -VESServer parameter is not passed to a cmdlet, VEShell will connect to the Virtualization Extensions Service running on localhost, with the default port number (8084) and credentials of the user who launched the VEShell console.
You can override the default connection settings by using the Start-VEShellClient cmdlet. This can be useful if you are working with the Virtualization Extensions Service that is listening to the non-default port, if the service is running on a remote machine and so on.
This command changes the default Virtualization Extensions Service location and the default port number:
Start-VEShellClient -ServerName vesserver -ServerPort 8086
After you change the default connection settings, all VEShell commands will be executed for the Virtualization Extensions Service that is running on the "vesserver" machine. To establish connection with this service, VEShell will use port number 8086.
To learn more about overriding default connection settings, see Start-VEShellClient.