< Back
New-vRANATNetworkProfile
Post
NAME New-vRANATNetworkProfile
SYNOPSIS
Create a vRA nat network profile
SYNTAX
New-vRANATNetworkProfile -Name <String> [-Description <String>] -SubnetMask <String> [-GatewayAddress <String>]
-ExternalNetworkProfile <String> [-PrimaryDNSAddress <String>] [-SecondaryDNSAddress <String>] [-DNSSuffix
<String>] [-DNSSearchSuffix <String>] [-PrimaryWinsAddress <String>] [-SecondaryWinsAddress <String>] [-IPRanges
<PSObject[]>] -NatType <String> [-DHCPEnabled] [-DHCPStartAddress <String>] [-DHCPEndAddress <String>]
[-DHCPLeaseTime <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-vRANATNetworkProfile -Name <String> [-Description <String>] -SubnetMask <String> [-GatewayAddress <String>]
-ExternalNetworkProfile <String> [-UseExternalNetworkProfileSettings] [-IPRanges <PSObject[]>] -NatType <String>
[-DHCPEnabled] [-DHCPStartAddress <String>] [-DHCPEndAddress <String>] [-DHCPLeaseTime <Int32>] [-WhatIf]
[-Confirm] [<CommonParameters>]
DESCRIPTION
Create a vRA nat network profile
PARAMETERS
-Name <String>
The network profile Name
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Description <String>
The network profile Description
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SubnetMask <String>
The subnet mask of the network profile
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-GatewayAddress <String>
The gateway address of the network profile
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ExternalNetworkProfile <String>
The external network profile that will be linked to that Routed or NAT network profile
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-UseExternalNetworkProfileSettings [<SwitchParameter>]
Use the settings from the selected external network profile
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-PrimaryDNSAddress <String>
The address of the primary DNS server
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecondaryDNSAddress <String>
The address of the secondary DNS server
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DNSSuffix <String>
The DNS suffix
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DNSSearchSuffix <String>
The DNS search suffix
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PrimaryWinsAddress <String>
The address of the primary wins server
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecondaryWinsAddress <String>
The address of the secondary wins server
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IPRanges <PSObject[]>
An array of ip address ranges
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-NatType <String>
The nat type. This can be One-to-One or One-to-Many
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DHCPEnabled [<SwitchParameter>]
Enable DHCP for a NAT network profile. Nat type must be One-to-Many
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-DHCPStartAddress <String>
The start address of the dhcp range
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DHCPEndAddress <String>
The end address of the dhcp range
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DHCPLeaseTime <Int32>
The dhcp lease time in seconds. The default is 0.
Required? false
Position? named
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String
System.Int
System.Switch
PSCustomObject
OUTPUTS
System.Management.Automation.PSObject
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>$DefinedRange1 = New-vRANetworkProfileIPRangeDefinition -Name "External-Range-01" -Description "Example 1"
-StartIPv4Address "10.70.1.2" -EndIPv4Address "10.70.1.5"
New-vRANATNetworkProfile -Name Network-NAT -Description "NAT" -SubnetMask "255.255.255.0" -GatewayAddress
"10.70.1.1" -PrimaryDNSAddress "10.70.1.100" -SecondaryDNSAddress "10.70.1.101" -DNSSuffix "corp.local"
-DNSSearchSuffix "corp.local" -NatType ONETOMANY -ExternalNetworkProfile "Network-External" -DHCPEnabled
-DHCPStartAddress "10.70.1.20" -DHCPEndAddress "10.70.1.30" -IPRanges $DefinedRange1
RELATED LINKS
SYNOPSIS
Create a vRA nat network profile
SYNTAX
New-vRANATNetworkProfile -Name <String> [-Description <String>] -SubnetMask <String> [-GatewayAddress <String>]
-ExternalNetworkProfile <String> [-PrimaryDNSAddress <String>] [-SecondaryDNSAddress <String>] [-DNSSuffix
<String>] [-DNSSearchSuffix <String>] [-PrimaryWinsAddress <String>] [-SecondaryWinsAddress <String>] [-IPRanges
<PSObject[]>] -NatType <String> [-DHCPEnabled] [-DHCPStartAddress <String>] [-DHCPEndAddress <String>]
[-DHCPLeaseTime <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-vRANATNetworkProfile -Name <String> [-Description <String>] -SubnetMask <String> [-GatewayAddress <String>]
-ExternalNetworkProfile <String> [-UseExternalNetworkProfileSettings] [-IPRanges <PSObject[]>] -NatType <String>
[-DHCPEnabled] [-DHCPStartAddress <String>] [-DHCPEndAddress <String>] [-DHCPLeaseTime <Int32>] [-WhatIf]
[-Confirm] [<CommonParameters>]
DESCRIPTION
Create a vRA nat network profile
PARAMETERS
-Name <String>
The network profile Name
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Description <String>
The network profile Description
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SubnetMask <String>
The subnet mask of the network profile
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-GatewayAddress <String>
The gateway address of the network profile
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ExternalNetworkProfile <String>
The external network profile that will be linked to that Routed or NAT network profile
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-UseExternalNetworkProfileSettings [<SwitchParameter>]
Use the settings from the selected external network profile
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-PrimaryDNSAddress <String>
The address of the primary DNS server
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecondaryDNSAddress <String>
The address of the secondary DNS server
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DNSSuffix <String>
The DNS suffix
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DNSSearchSuffix <String>
The DNS search suffix
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PrimaryWinsAddress <String>
The address of the primary wins server
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecondaryWinsAddress <String>
The address of the secondary wins server
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IPRanges <PSObject[]>
An array of ip address ranges
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-NatType <String>
The nat type. This can be One-to-One or One-to-Many
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DHCPEnabled [<SwitchParameter>]
Enable DHCP for a NAT network profile. Nat type must be One-to-Many
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-DHCPStartAddress <String>
The start address of the dhcp range
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DHCPEndAddress <String>
The end address of the dhcp range
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DHCPLeaseTime <Int32>
The dhcp lease time in seconds. The default is 0.
Required? false
Position? named
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String
System.Int
System.Switch
PSCustomObject
OUTPUTS
System.Management.Automation.PSObject
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>$DefinedRange1 = New-vRANetworkProfileIPRangeDefinition -Name "External-Range-01" -Description "Example 1"
-StartIPv4Address "10.70.1.2" -EndIPv4Address "10.70.1.5"
New-vRANATNetworkProfile -Name Network-NAT -Description "NAT" -SubnetMask "255.255.255.0" -GatewayAddress
"10.70.1.1" -PrimaryDNSAddress "10.70.1.100" -SecondaryDNSAddress "10.70.1.101" -DNSSuffix "corp.local"
-DNSSearchSuffix "corp.local" -NatType ONETOMANY -ExternalNetworkProfile "Network-External" -DHCPEnabled
-DHCPStartAddress "10.70.1.20" -DHCPEndAddress "10.70.1.30" -IPRanges $DefinedRange1
RELATED LINKS