PowerCLI Reference

New-OrgVdcNetwork

Synopsis

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

Syntax

New-OrgVdcNetwork [-Description <String>] -Direct -ExternalNetwork <ExternalNetwork> -Name <String> -OrgVdc <OrgVdc> [-RunAsync] [-Server <CIServer[]>] [-WhatIf] [<CommonParameters>]

New-OrgVdcNetwork [-Description <String>] [-DnsSuffix <String>] -Gateway <IPAddress> -Internal -Name <String> -Netmask <IPAddress> -OrgVdc <OrgVdc> [-PrimaryDns <IPAddress>] [-RunAsync] [-SecondaryDns <IPAddress>] [-Server <CIServer[]>] [-StaticIPPool <IPRangeList>] [-WhatIf] [<CommonParameters>]

New-OrgVdcNetwork [-Description <String>] [-DnsSuffix <String>] -Gateway <IPAddress> -Name <String> -Netmask <IPAddress> -OrgVdc <OrgVdc> [-PrimaryDns <IPAddress>] -Routed -EdgeGateway <EdgeGateway> [-RunAsync] [-SecondaryDns <IPAddress>] [-Server <CIServer[]>] [-StaticIPPool <IPRangeList>] [-WhatIf] [<CommonParameters>]

Related Commands

Get-OrgVdcNetwork
Remove-OrgVdcNetwork
Set-OrgVdcNetwork

Detailed Description

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

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
DescriptionStringSpecifies a description for the organization VDC network that you want to create.falseFalse
DirectSwitchParameterIndicates that you want to create an organization VDC network that is connected directly to an external network.trueFalse
DnsSuffixStringSpecifies the Domain Name System (DNS) suffix of the organization VDC network that you want to create.falseFalse
EdgeGatewayEdgeGatewayEdge gateway to which the routed org vdc network connects to.trueFalse
ExternalNetworkExternalNetworkSpecifies the external network to which the organization VDC network connects. This parameter is mandatory when the Direct or Routed parameter is specified.trueTrue (ByValue)
GatewayIPAddressSpecifies the gateway of the organization VDC network that you want to create.trueFalse
InternalSwitchParameterIndicates that you want to create an internal organization VDC network.trueFalse
NameStringSpecifies a name for the organization VDC network that you want to create.trueFalse
NetmaskIPAddressSpecifies the network mask of the organization VDC network that you want to create.trueFalse
OrgVdcOrgVdcSpecifies the organization VDC for which you want to create the organization VDC network.trueTrue (ByValue)
PrimaryDnsIPAddressSpecifies the primary Domain Name System (DNS) of the organization VDC network that you want to create.falseFalse
RoutedSwitchParameterIndicates that you want to create a routed organization VDC network.trueFalse
RunAsyncSwitchParameterIndicates 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.falseFalse
SecondaryDnsIPAddressSpecifies the secondary Domain Name System (DNS) of the organization VDC network that you want to create.falseFalse
ServerCIServer[]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 the Connect-CIServer cmdlet.falseFalse
StaticIPPoolIPRangeListSpecifies a range of static IP addresses that the organization VDC network will allocate to virtual machines.falseFalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falseFalse

Return Type

The newly created OrgVdcNetwork object

Notes

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.


Copyright © VMware, Inc. All rights reserved.