Connect-VE
Opens a connection to the Virtualization Extensions Service.
Applies to versions: 8.0, 9.0, 9a
Syntax
Connect-VE [-ConnectionSession] <VesConnection> [<CommonParameters>] |
Detailed Description
This cmdlet opens a connection to the Virtualization Extensions Service that is specified with the -ConnectionSession parameter. When the connection is open, you can perform configuration of Virtualization Extensions Service using VEShell cmdlets.
To establish a connection to the Virtualization Extensions Service, you need to pass to the cmdlet a connection object created with the New-VEConnection cmdlet.
The cmdlet can be used to establish a new connection to the Virtualization Extensions Service or re-establish a previously closed connection. You can use the same connection object to open connection to the Virtualization Extensions Service multiple times.
Note |
If there is no activity or communication between VEShell and the Virtualization Extensions Service for the period of 15 minutes, the connection will time out. |
Parameters
-ConnectionSession <VesConnection>
Specifies the connection object created for the Virtualization Extensions Service.
Description | |
Aliases |
|
Required? | True |
Position? | 1 |
Default Value |
|
Accept Pipeline Input? | True (ByValue, ByPropertyName) |
Accept Wildcard Characters? | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see Microsoft Docs.
Input
The cmdlet accepts the Veeam.Psves.VesConnection object as the input value.
Output
The cmdlet returns a Veeam.Psves.VesConnection object that stores settings for connecting to the Virtualization Extensions Service. The State property of the object is set to “Open”.
Example
The following command checks whether the Virtualization Extensions Service on the localhost is available.
New-VEConnection –ComputerName localhost | Connect-VE | Disconnect-VE |
If the Virtualization Extensions Service is available, the cmdlet will return a connection object (with the “Close” state).