Syntax
Import-CIVApp [-VM] <VirtualMachine> [-ComputerName <String>] [-Description <String>] [-Name <String>] [-NoCopy] [-Server <CIServer[]>] -OrgVdc <OrgVdc> [-WhatIf] [-Confirm] [<CommonParameters>]Related Commands
Online versionDetailed Description
Imports a virtual machine from the underlying vSphere to the vCloud as a virtual appliance. You can import the virtual machine to an already existing virtual appliance or create a new virtual appliance and import the virtual machine into it. Note: This cmdlet is only available to Provider Administrators.Parameters
| Name | Type | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|---|
| VM | VirtualMachine | Specify the virtual machine you want to import into the vCloud. This parameter takes VirtualMachine objects retrieved from a vCenter Server that has already been registered with the vCloud. | true | true (ByValue) | |
| ComputerName | String | Specify a computer name for the imported virtual machine. | false | false | |
| Confirm | SwitchParameter | If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation. | false | false | |
| Description | String | Specify a description for the imported virtual machine. | false | false | |
| Name | String | Specify a new name for the imported virtual machine. If not specified, the imported virtual machine takes the name of the vSphere virtual machine. | false | false | |
| NoCopy | SwitchParameter | Use this parameter if you want to import the original vSphere virtual machine. Otherwise, a copy of the virtual machine is imported in the vCloud. Importing the original vSphere virtual machine might cause its modification. | false | false | |
| OrgVdc | OrgVdc | Specify the organization VDC to which you want to import the virtual machine. | true | true (ByValue) | |
| Server | CIServer[] | Specify the cloud servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-CIServer. | false | false | |
| VApp | CIVApp | Specify the virtual appliance into which you want to import the virtual machine. | true | true (ByValue) | |
| WhatIf | SwitchParameter | Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | false |
Return Type
CIVAppNotes
Examples
-------------- Example 1 --------------
Get-OrgVdc 'MyOrganizationVdc' | Import-CIVApp -VM (Get-VM 'MyVMToImport')
Imports a virtual machine from vSphere into a new cloud virtual appliance.
Note: You must be connected to a vCenter Server and a vCloud Director server.
-------------- Example 2 --------------
(Get-VM 'MyVMToImport') | Import-CIVApp -OrgVdc 'MyOrganizationVdc' -Name 'MyNewVApp' -Description "My New VApp Description" -ComputerName "MyComputer"
Imports a virtual machine from vSphere into a new cloud virtual appliance (Vapp) while specifying the new VApp name, its description and the virtual machine computer name.
Note: You must be connected to a vCenter Server and a vCloud Director server.
-------------- Example 3 --------------
Import-CIVApp -VM (Get-VM 'MyVMToImport') -OrgVdc 'MyOrganizationVdc' -NoCopy
Imports a virtual machine from vSphere into a new cloud virtual appliance by moving it instead of copying it.
Note: You must be connected to a vCenter Server and a vCloud Director server.
-------------- Example 4 --------------
Import-CIVApp -VM (Get-VM 'MyVMToImport') -VApp 'MyVAppToExtend'
Imports a virtual machine from vSphere into an existing cloud virtual appliance.
Note: You must be connected to a vCenter Server and a vCloud Director server.
-------------- Example 5 --------------
Get-CIVApp "MyVAppToExtend" | Import-CIVApp (Get-VM 'MyVMToImport') -NoCopy
Imports a VM from vSphere into an existing cloud VApp by moving it instead of copying it.
Note: You must be connected to a vCenter Server and a vCloud Director server.