powershellscripts.com

Tutorials  PowerShell Cmdlet Help for New-VApp



NAME
New-VApp

SYNOPSIS
Creates a new virtual appliance.

SYNTAX
New-VApp -Location [-Name] [-CpuExpandableReservation []] [-CpuLimitMhz ] [-
CpuReservationMhz ] [-CpuSharesLevel ] [-MemExpandableReservation []] [-MemLimitMB t64>] [-MemReservationMB ] [-MemSharesLevel ] [-NumCpuShares ] [-NumMemShares ] [
-Server ] [-RunAsync] [-WhatIf] [-Confirm] []

New-VApp -Location [[-Name] ] -VApp [-VMHost ] [-Datastore ] [-Serv
er ] [-RunAsync] [-WhatIf] [-Confirm] []


DESCRIPTION
Creates a new virtual appliance.


PARAMETERS
-Location
Specify a VApp, ResourcePool, VMHost, or Cluster object where you want to place the new virtual appliance.

Required? true
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? true

-Name
Specify a name for the new virtual appliance.

Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false

-CpuExpandableReservation []
Indicate that the CPU reservation can grow beyond the specified value if there are available resources.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-CpuLimitMhz
Specify a CPU usage limit in MHz. Utilization will not exceed this limit even if there are available resources.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-CpuReservationMhz
Specify the CPU size in MHz that is guaranteed to be available.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-CpuSharesLevel
Specify the CPU allocation level for this virtual appliance. This property is used in relative allocation betwe
en resource consumers. The valid values are Custom, High, Low, and Normal.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-MemExpandableReservation []
If the value is $true, the memory reservation can grow beyond the specified value if there are available resour
ces.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-MemLimitMB
Specify a memory usage limit in MB. Utilization will not exceed this limit even if there are available resource
s.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-MemReservationMB
Specify the size of the memory in MB that is guaranteed to be available.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-MemSharesLevel
Specify the memory allocation level for this virtual appliance. This property is used in relative allocation be
tween resource consumers. The valid values are Custom, High, Low, and Normal.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-NumCpuShares
Specify the CPU allocation level for this virtual appliance. This property is used in relative allocation betwe
en resource consumers. This parameter is ignored unless the CpuSharesLevel parameter is set to Custom.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-NumMemShares
Specify the memory allocation level for this virtual appliance. This property is used in relative allocation be
tween resource consumers. This parameter is ignored unless the MemSharesLevel parameter is set to Custom.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Server
Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the co
mmand runs on the default servers. For more information about default servers, see the description of Connect-V
IServer.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true

-RunAsync
Indicate that the command returns immediately without waiting for the task to complete. In this mode, the outpu
t of the cmdlet is a Task object. For more information about the -RunAsync parameter run " help About_RunAsync"
in the vSphere PowerCLI console.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf
Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modi
fied.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm
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.

Required? false
Position? named
Default value $true
Accept pipeline input? false
Accept wildcard characters? false

-VApp
Specify a virtual appliance you want to copy.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? true

-VMHost
Specify the host where you want to run the copied virtual appliance.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true

-Datastore
Specify the datastore where you want to store the copied virtual appliance. If you do not specify a datastore,
the cmdlet takes the first datastore of the host or cluster.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
vApp


NOTES




-------------- Example 1 --------------

C:\PS>New-VApp -Name VApp -CpuLimitMhz 4000 -CpuReservationMhz 1000 -Location Host


Creates a new virtual appliance on the Host host.






RELATED LINKS
Online version: http://www.vmware.com/support/developer/PowerCLI/PowerCLI501/html/New-VApp.html
Export-VApp
Get-VApp
Import-VApp
Remove-VApp
Set-VApp
Start-VApp
Stop-VApp
Move-VApp