New-OrgNetwork

This cmdlet creates a new organization network on a vCloud Director server. Note: This cmdlet is only available to Provider Administrators.

Syntax

-Direct
-ExternalNetwork  <ExternalNetwork>
-Name  <String>
-Org  <Org>
[-Description  <String>]
[-RunAsync]
[-Server  <CIServer[]>]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Direct
SwitchParameter named Indicates that you want to create an organization network that is connected directly to an external network.
required
ExternalNetwork
ExternalNetwork named
  • pipeline
  • Specifies the external network to which the organization network connects. This parameter is mandatory when the Direct or Routed parameter is specified.
    required
    Name
    String named Specifies a name for the organization network that you want to create.
    required
    Org
    Org named
  • pipeline
  • Specifies the organization for which you want to create the organization network.
    optional
    Description
    String named Specifies a description for the organization 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
    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>
    -Internal
    -Name  <String>
    -Netmask  <IPAddress>
    -NetworkPool  <NetworkPool>
    -Org  <Org>
    [-Description  <String>]
    [-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 gateway of the organization network that you want to create.
    required
    Internal
    SwitchParameter named Indicates that you want to create an internal organization network.
    required
    Name
    String named Specifies a name for the organization network that you want to create.
    required
    Netmask
    IPAddress named Specifies the network mask of the organization network that you want to create.
    required
    NetworkPool
    NetworkPool named
  • pipeline
  • Specifies the network pool that allocates network resources for the organization network that you want to create. This parameter is mandatory when the Internal or Routed parameter is specified.
    required
    Org
    Org named
  • pipeline
  • Specifies the organization for which you want to create the organization network.
    optional
    Description
    String named Specifies a description for the organization network that you want to create.
    optional
    DnsSuffix
    String named Specifies the DNS suffix of the organization network that you want to create.
    optional
    PrimaryDns
    IPAddress named Specifies the primary DNS of the organization 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 the secondary DNS of the organization network that 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 that the organization network will allocate to virtual machines.

    -ExternalNetwork  <ExternalNetwork>
    -Gateway  <IPAddress>
    -Name  <String>
    -Netmask  <IPAddress>
    -NetworkPool  <NetworkPool>
    -Org  <Org>
    -Routed
    [-Description  <String>]
    [-DnsSuffix  <String>]
    [-PrimaryDns  <IPAddress>]
    [-RunAsync]
    [-SecondaryDns  <IPAddress>]
    [-Server  <CIServer[]>]
    [-StaticIPPool  <IPRangeList>]
    [CommonParameters]

    Parameters

    Required Parameter Name Type Position Features Description
    required
    ExternalNetwork
    ExternalNetwork named
  • pipeline
  • Specifies the external network to which the organization network connects. This parameter is mandatory when the Direct or Routed parameter is specified.
    required
    Gateway
    IPAddress named Specifies the gateway of the organization network that you want to create.
    required
    Name
    String named Specifies a name for the organization network that you want to create.
    required
    Netmask
    IPAddress named Specifies the network mask of the organization network that you want to create.
    required
    NetworkPool
    NetworkPool named
  • pipeline
  • Specifies the network pool that allocates network resources for the organization network that you want to create. This parameter is mandatory when the Internal or Routed parameter is specified.
    required
    Org
    Org named
  • pipeline
  • Specifies the organization for which you want to create the organization network.
    required
    Routed
    SwitchParameter named Indicates that you want to create a routed organization network.
    optional
    Description
    String named Specifies a description for the organization network that you want to create.
    optional
    DnsSuffix
    String named Specifies the DNS suffix of the organization network that you want to create.
    optional
    PrimaryDns
    IPAddress named Specifies the primary DNS of the organization 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 the secondary DNS of the organization network that 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 that the organization network will allocate to virtual machines.

    Output

    VMware.VimAutomation.Cloud.Types.V1.OrgNetwork

    Examples


    Example 1

    New-OrgNetwork -Direct -Name 'MyOrgDirectNetwork' -Org 'MyOrganization' -ExternalNetwork 'MyExternalNetwork' -Description "The network has direct connection to the internet. Do not store sensitive data on the virtual machines connected to the network."

    Creates a new organization network that is directly connected to the specified external network.

    Example 2

    New-OrgNetwork -Internal -Name 'MyOrgInternalNetwork' -Org 'MyOrganization' -NetworkPool 'MyNetworkPool' -Gateway "192.166.10.10" -PrimaryDns "192.166.10.1" -Netmask "255.255.255.0" -Description "The network has no internet connection."

    Creates a new internal organization network with a specified gateway, primary DNS, and network mask.

    Example 3

    New-OrgNetwork -Routed -Name 'MyOrgRoutedOrgNetwork' -Org 'MyOrg' -ExternalNetwork 'MyExternalNetwork' -NetworkPool 'MyNetworkPool' -Gateway "192.166.10.10" -PrimaryDns "192.166.10.1" -Netmask "255.255.255.0" -StaticIPPool "192.166.10.2-192.166.10.5" -Description "This network is secured with NAT routing. Network traffic can be monitored. The virtual machines connected to this organization network are protected from malware."

    Creates a new routed organization network with a specified gateway, primary DNS, network mask, and a range of static IP addresses that will be allocated to the virtual machines in the network.

    Related Commands

    Feedback

    Was this page helpful?