## PowerCLI Reference

# New-OrgNetwork

## Synopsis

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

Syntax

New-OrgNetwork -Name <String> [-Description <String>] -Direct -Org <Org> -ExternalNetwork <ExternalNetwork> [-Server <CIServer[]>] [-RunAsync] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-OrgNetwork -Name <String> [-Description <String>] -Internal -Org <Org> -NetworkPool <NetworkPool> -Gateway <IPAddress> -Netmask <IPAddress> [-DnsSuffix <String>] [-PrimaryDns <IPAddress>] [-SecondaryDns <IPAddress>] [-StaticIPPool <IPRangeList>] [-Server <CIServer[]>] [-RunAsync] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-OrgNetwork -Name <String> [-Description <String>] -Routed -Org <Org> -ExternalNetwork <ExternalNetwork> -NetworkPool <NetworkPool> -Gateway <IPAddress> -Netmask <IPAddress> [-DnsSuffix <String>] [-PrimaryDns <IPAddress>] [-SecondaryDns <IPAddress>] [-StaticIPPool <IPRangeList>] [-Server <CIServer[]>] [-RunAsync] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-OrgNetwork
Remove-OrgNetwork
Set-OrgNetwork

Detailed Description

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

Parameters

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 organization network that you want to create. | false | false
Direct | SwitchParameter | Indicates that you want to create an organization network that is connected directly to an external network. | true | false
DnsSuffix | String | Specifies the DNS suffix of the organization network that you want to create. | false | false
ExternalNetwork | ExternalNetwork | Specifies the external network to which the organization network connects. This parameter is mandatory when the Direct or Routed parameter is specified. | true | true (ByValue)
Gateway | IPAddress | Specifies the gateway of the organization network that you want to create. | true | false
InformationAction | ActionPreference |  | false | false
InformationVariable | String |  | false | false
Internal | SwitchParameter | Indicates that you want to create an internal organization network. | true | false
Name | String | Specifies a name for the organization network that you want to create. | true | false
Netmask | IPAddress | Specifies the network mask of the organization network that you want to create. | true | false
NetworkPool | NetworkPool | 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. | true | true (ByValue)
Org | Org | Specifies the organization for which you want to create the organization network. | true | true (ByValue)
PipelineVariable | String |  | false | false
PrimaryDns | IPAddress | Specifies the primary DNS of the organization network that you want to create. | false | false
Routed | SwitchParameter | Indicates that you want to create a routed organization network. | 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 the secondary DNS of the organization network that 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 that the organization network will allocate to virtual machines. | false | false
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

Return Type

The newly created OrgNetwork object

Notes

You can run this cmdlet only against vCloud Director 1.5.x environments.

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.

Copyright © VMware, Inc. All rights reserved.