Reference Guide › AutoShell › AutoShell Loadable Modules' Command Reference › CA VMware vCenter Server AutoShell Commands › dpmvc vapp Command--Manage vApp

dpmvc vapp Command--Manage vApp

The dpmvc vapp command supports the following operations on vApps:

• Create New vApp
• Clone
• Power On
• Power Off
• Suspend
• Delete vApp from VMware vCenter
• Unregister from VMware vCenter
• Add VMs to vApp
• Add resource pool to vApp
• Add vApps to a vApp
• Update vApp configuration

The command has the following formats:

dpmvc-vapp -create

-vc_server vcservername
-vapp_path vapppath
[-vapp_name vappname]
[-cpu_allocation isExpandableReservation, limit, reservation, sharesLevel, shares]
[-mem_allocation isExpandableReservation, limit, reservation, sharesLevel, shares]

dpmvc-vapp -clone

-vc_server vcservername
-vapp_path vapppath
[-target_vapp_path targetvapppath]
[-vapp_name vappname]
[-target_vapp_host targetvapphost]
[-target_vapp_datastore targetvappdatastore]

dpmvc-vapp [-power_on | -power_off | -suspend | -delete | -unregister ]

-vc_server vcservername
-vapp_path vapppath

dpmvc-vapp -add_vms_to_vapp 

-vc_server vcservername
-vapp_path vapppath
[-vapp_name vappname]
[-vms vms]

dpmvc-vapp -add_rps_to_vapp 

-vc_server vcservername
-vapp_path vapppath
[-vapp_name vappname]
[-rps resourcepool]

dpmvc-vapp -add_vapps_to_vapp 

-vc_server vcservername
-vapp_path vapppath
[-vapp_name vappname]
[-vapps vapps]
[-locale iso639value]

dpmvc-vapp -update_vapp_config 

-vc_server vcservername
-vapp_path vapppath
[-vapp_name vappname]
[-config_settings vappName,objecType,startAction,startDelay,startOrder,stopAction,stopDelay,waitForGuest]
[-cpu_allocation isExpandableReservation, limit, reservation, sharesLevel, shares]
[-mem_allocation isExpandableReservation, limit, reservation, sharesLevel, shares]
[-locale iso639value]

-vc_server vcservername

Specifies the vCenter Server to access when you have multiple vCenter Servers. Optional for single vCenter Server environments.

-vapp_path vapppath

Specifies the vApp path.

-vapp_name vappname

(Optional) Specifies the vApp name.

-cpu_allocation isExpandableReservation, limit, reservation, sharesLevel, shares

(Optional) Specifies the CPU allocation settings when updating a vApp configuration.

isExpandableReservation

Specifies if the allocation is expandable. Possible values: true or false.

limit

Specifies the allocation limit.

reservation

Specifies the reservation allocation.

sharesLevel

Specifies the shares level that is 0 for low, 1 for normal, 2 for high and 3 for custom. e.g. true,-1,1000,1,4000

shares

Specifies the allocation shares.

-mem_allocation isExpandableReservation, limit, reservation, sharesLevel, shares

Specifies the memory allocation settings when updating a vApp configuration.

isExpandableReservation

Specifies if the allocation is expandable. Possible values: true or false.

limit

Specifies the allocation limit.

reservation

Specifies the reservation allocation.

sharesLevel

Specifies the shares level that is 0 for low, 1 for normal, 2 for high and 3 for custom. e.g. true,-1,1000,1,4000

shares

Specifies the allocation shares.

-vms vms

(Optional) Specifies the VMs you want to add to vApp.

-rps resourcepool

(Optional) Specifies the name of the resource pool which you want to add to a vApp.

-vapps vapps

(Optional) Specifies the vApps you want to add to a vApp.

-config_settings vappName,objecType,startAction,startDelay,startOrder,stopAction,stopDelay,waitForGuest

(Optional) Specifies the configuration settings of the vApp. Proper format is "

startAction none|powerOn

Specifies the start action. The available options are none or powerOn

stopAction none|powerOff|guestShutdown|suspend

Specifies the start action. The available options are none or powerOff or guestShutdown or suspend.

-target_vapp_path targetvapppath

Specifies the target vApp path of the vApp you want to create.

-target_vapp_host targetvapphost

(Optional) Specifies the host where the new vApp is to reside on.

-target_vapp_datastore targetvappdatastore

(Optional) Specifies the name of the data store where the vApp is to reside on.