New-CIVAppNetwork

This cmdlet creates a new vApp network. * To create a direct vApp network, specify the Direct parameter.

Syntax

-Direct
-ParentOrgVdcNetwork  <OrgNetworkBase>
-VApp  <CIVApp>
[-RunAsync]
[-Server  <CIServer[]>]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Direct
SwitchParameter named 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.
required
ParentOrgVdcNetwork
OrgNetworkBase named 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.
required
VApp
CIVApp named
  • pipeline
  • Specifies the vApp for which you want to create a vApp network.
    optional
    RunAsync
    SwitchParameter named 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.
    optional
    Server
    CIServer[] named 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.

    -Gateway  <IPAddress>
    -Name  <String>
    -Netmask  <IPAddress>
    -ParentOrgVdcNetwork  <OrgNetworkBase>
    -Routed
    -VApp  <CIVApp>
    [-Description  <String>]
    [-DisableFirewall]
    [-DnsSuffix  <String>]
    [-PrimaryDns  <IPAddress>]
    [-RunAsync]
    [-SecondaryDns  <IPAddress>]
    [-Server  <CIServer[]>]
    [-StaticIPPool  <IPRangeList>]
    [CommonParameters]

    Parameters

    Required Parameter Name Type Position Features Description
    required
    Gateway
    IPAddress named Specifies the default gateway for the vApp network that you want to create.
    required
    Name
    String named Specifies a name for the vApp network that you want to create.
    required
    Netmask
    IPAddress named Specifies a network mask for the vApp network that you want to create.
    required
    ParentOrgVdcNetwork
    OrgNetworkBase named 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.
    required
    Routed
    SwitchParameter named 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.
    required
    VApp
    CIVApp named
  • pipeline
  • Specifies the vApp for which you want to create a vApp network.
    optional
    Description
    String named Specifies a description for the vApp network that you want to create.
    optional
    DisableFirewall
    SwitchParameter named 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.
    optional
    DnsSuffix
    String named Specifies a DNS suffix for the vApp network that you want to create.
    optional
    PrimaryDns
    IPAddress named Specifies a primary DNS for the vApp network that you want to create.
    optional
    RunAsync
    SwitchParameter named 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.
    optional
    SecondaryDns
    IPAddress named Specifies a secondary DNS for the vApp network you want to create.
    optional
    Server
    CIServer[] named 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.
    optional
    StaticIPPool
    IPRangeList named 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".

    Output

    VMware.VimAutomation.Cloud.Types.V1.CIVAppNetwork

    Examples


    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.

    Related Commands

    Feedback

    Was this page helpful?