New-OrgVdcNetwork Command | Vmware PowerCLI Reference

New-OrgVdcNetwork

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

Syntax

New-OrgVdcNetwork
-Direct
-ExternalNetwork < ExternalNetwork >
-Name < String >
-OrgVdc < OrgVdc >
[-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 VDC network that is connected directly to an external network.
required
ExternalNetwork ExternalNetwork named
  • pipeline
Specifies the external network to which the organization VDC network connects. This parameter is mandatory when the Direct or Routed parameter is specified.
required
Name String named
Specifies a name for the organization VDC network that you want to create.
required
OrgVdc OrgVdc named
  • pipeline
Specifies the organization VDC for which you want to create the organization VDC network.
optional Description String named
Specifies a description for the organization VDC 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 provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-CIServer cmdlet.
New-OrgVdcNetwork
-Gateway < IPAddress >
-Internal
-Name < String >
-Netmask < IPAddress >
-OrgVdc < OrgVdc >
[-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 VDC network that you want to create.
required
Internal SwitchParameter named
Indicates that you want to create an internal organization VDC network.
required
Name String named
Specifies a name for the organization VDC network that you want to create.
required
Netmask IPAddress named
Specifies the network mask of the organization VDC network that you want to create.
required
OrgVdc OrgVdc named
  • pipeline
Specifies the organization VDC for which you want to create the organization VDC network.
optional Description String named
Specifies a description for the organization VDC network that you want to create.
optional DnsSuffix String named
Specifies the Domain Name System (DNS) suffix of the organization VDC network that you want to create.
optional PrimaryDns IPAddress named
Specifies the primary Domain Name System (DNS) of the organization VDC 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 Domain Name System (DNS) of the organization VDC 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 provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-CIServer cmdlet.
optional StaticIPPool IPRangeList named
Specifies a range of static IP addresses that the organization VDC network will allocate to virtual machines.
New-OrgVdcNetwork
-EdgeGateway < EdgeGateway >
-Gateway < IPAddress >
-Name < String >
-Netmask < IPAddress >
-OrgVdc < OrgVdc >
-Routed
[-Description < String > ]
[-DnsSuffix < String > ]
[-PrimaryDns < IPAddress > ]
[-RunAsync ]
[-SecondaryDns < IPAddress > ]
[-Server < CIServer[] > ]
[-StaticIPPool < IPRangeList > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
EdgeGateway EdgeGateway named
Edge gateway to which the routed org vdc network connects to.
required
Gateway IPAddress named
Specifies the gateway of the organization VDC network that you want to create.
required
Name String named
Specifies a name for the organization VDC network that you want to create.
required
Netmask IPAddress named
Specifies the network mask of the organization VDC network that you want to create.
required
OrgVdc OrgVdc named
  • pipeline
Specifies the organization VDC for which you want to create the organization VDC network.
required
Routed SwitchParameter named
Indicates that you want to create a routed organization VDC network.
optional Description String named
Specifies a description for the organization VDC network that you want to create.
optional DnsSuffix String named
Specifies the Domain Name System (DNS) suffix of the organization VDC network that you want to create.
optional PrimaryDns IPAddress named
Specifies the primary Domain Name System (DNS) of the organization VDC 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 Domain Name System (DNS) of the organization VDC 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 provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-CIServer cmdlet.
optional StaticIPPool IPRangeList named
Specifies a range of static IP addresses that the organization VDC network will allocate to virtual machines.

Output

VMware.VimAutomation.Cloud.Types.V1.OrgVdcNetwork

Examples

Example 1

New-OrgVdcNetwork -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 that are connected to the network."

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

Example 2

New-OrgVdcNetwork -Internal -Name 'MyOrgInternalNetwork' -Org 'MyOrganization' -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 VDC network with a specified gateway, primary Domain Name System (DNS), and network mask.

Example 3

New-OrgVdcNetwork -Routed -Name 'MyOrgRoutedOrgNetwork' -OrgVdc 'MyOrgVdc' -EdgeGateway 'MyEdgeGateway' -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 Network Address Translation (NAT) routing. Network traffic can be monitored. The virtual machines connected to this organization VDC network are protected from malware."

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

Related Commands

Org

This cmdlet retrieves cloud organizations.

This cmdlet creates a new organization.

This cmdlet removes the specified organization.

This cmdlet modifies the configuration of the specified organization.

OrgVdc

This cmdlet retrieves organization vDCs.

This cmdlet creates an organization virtual datacenter (vDC).

This cmdlet removes organization virtual datacenters (vDCs).

This cmdlet modifies the configuration of the specified organization virtual datacenter (vDC).

OrgVdcNetwork

This cmdlet retrieves organization vDC networks.

This cmdlet creates a new organization VDC network on a vCloud Director server.

This cmdlet deletes the specified organization VDC network.

This cmdlet modifies the configuration of the specified organization network.