New-CIVAppNetwork

Name	Type	Description	Required?	Pipeline Input	Default Value
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	Specifies a description for the vApp network that you want to create.	false	False
Direct	SwitchParameter	Indicates that you want to create a vApp network that is directly connected to a parent organization network. When the Direct parameter is specified, you cannot specify the Routed parameter.	true	False
DisableFirewall	SwitchParameter	Indicates that you want to create a vApp network with a disabled firewall service. By default, when the Routed parameter is specified, the vApp network is created with an enabled firewall service.	false	False
DnsSuffix	String	Specifies a DNS suffix for the vApp network that you want to create.	false	False
Gateway	IPAddress	Specifies the default gateway for the vApp network that you want to create.	true	False
Name	String	Specifies a name for the vApp network that you want to create.	true	False
Netmask	IPAddress	Specifies a network mask for the vApp network that you want to create.	true	False
ParentOrgVdcNetwork	OrgNetworkBase	Specifies the parent organization vDC network to which the vApp network connects. Do not specify this parameter if you want to create an isolated vApp network.	true	False
PrimaryDns	IPAddress	Specifies a primary DNS for the vApp network that you want to create.	false	False
Routed	SwitchParameter	Indicates that you want to create a routed network. To create an isolated network, specify the Routed parameter but do not specify the ParentOrgParameter. When the Routed parameter is specified, you cannot specify the Direct parameter.	true	False
RunAsync	SwitchParameter	Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console.	false	False
SecondaryDns	IPAddress	Specifies a secondary DNS for the vApp network you want to create.	false	False
Server	CIServer[]	Specifies 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
StaticIPPool	IPRangeList	Specifies a range of static IP addresses for the vApp network to allocate to virtual machines. For example, "192.168.10.0 - 192.168.10.50, 192.168.10.100 - 192.168.10.150".	false	False
VApp	CIVApp	Specifies the vApp for which you want to create a vApp network.	true	True (ByValue)
WhatIf	SwitchParameter	Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	False

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

$myVApp = Get-CIVApp -Name 'MyVApp'
$parentOrgNetwork = Get-OrgNetwork -Name 'MyParentOrganizationNetwork'
New-CIVAppNetwork -ParentOrgNetwork $parentOrgNetwork -VApp $myVApp -Routed -Description 'This is my routed network.' -DnsSuffix 'mydomain.com' -Gateway '192.168.3.3' -Name 'MyRoutedNetwork' -Netmask '255.255.255.0' -PrimaryDns '192.168.3.1' -SecondaryDns '192.168.3.2' -StaticIPPool '192.168.3.100 - 92.168.3.120'

Creates a new routed vApp network with the specified configuration.

-------------------------- Example 2 --------------------------

$myVApp = Get-CIVApp -Name 'MyVApp'
New-CIVAppNetwork -ParentOrgNetwork $null -VApp $myVApp -Routed -Description 'This is my isolated network.' -DnsSuffix 'mydomain.com' -Gateway '192.168.3.3' -Name 'MyIsolatedNetwork' -Netmask '255.255.255.0' -PrimaryDns '192.168.3.1' -SecondaryDns '192.168.3.2' -StaticIPPool '192.168.3.100 - 192.168.3.120'

Createsa new isolated vApp network with the specified configuration.

-------------------------- Example 3 --------------------------

$myVApp = Get-CIVApp -Name 'MyVApp'
$parentOrgNetwork = Get-OrgNetwork -Name 'MyParentOrganizationNetwork'
New-CIVAppNetwork -ParentOrgNetwork $parentOrgNetwork -VApp $myVApp -Direct

Creates a new direct vApp network.

PowerCLI Reference

Synopsis