< Back
New-vRAExternalNetworkProfile
Post
NAME New-vRAExternalNetworkProfile
SYNOPSIS
Create a vRA external network profile
SYNTAX
New-vRAExternalNetworkProfile [-Name] <String> [[-Description] <String>] [-SubnetMask] <String> [[-GatewayAddress]
<String>] [[-PrimaryDNSAddress] <String>] [[-SecondaryDNSAddress] <String>] [[-DNSSuffix] <String>]
[[-DNSSearchSuffix] <String>] [[-IPRanges] <PSObject[]>] [[-PrimaryWinsAddress] <String>] [[-SecondaryWinsAddress]
<String>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Create a vRA external network profile
PARAMETERS
-Name <String>
The network profile Name
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Description <String>
The network profile Description
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SubnetMask <String>
The subnet mask of the network profile
Required? true
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-GatewayAddress <String>
The gateway address of the network profile
Required? false
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PrimaryDNSAddress <String>
The address of the primary DNS server
Required? false
Position? 5
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecondaryDNSAddress <String>
The address of the secondary DNS server
Required? false
Position? 6
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DNSSuffix <String>
The DNS suffix
Required? false
Position? 7
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DNSSearchSuffix <String>
The DNS search suffix
Required? false
Position? 8
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IPRanges <PSObject[]>
An array of ip address ranges
Required? false
Position? 9
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PrimaryWinsAddress <String>
The address of the primary wins server
Required? false
Position? 10
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecondaryWinsAddress <String>
The address of the secondary wins server
Required? false
Position? 11
Default value
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
PSCustomObject
OUTPUTS
System.Management.Automation.PSObject
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>$DefinedRange1 = New-vRANetworkProfileIPRangeDefinition -Name "External-Range-01" -Description "Example 1"
-StartIPv4Address "10.60.1.2" -EndIPv4Address "10.60.1.5"
$DefinedRange2 = New-vRANetworkProfileIPRangeDefinition -Name "External-Range-02" -Description "Example 2"
-StartIPv4Address "10.60.1.10" -EndIPv4Address "10.60.1.20"
New-vRAExternalNetworkProfile -Name Network-External -Description "External" -SubnetMask "255.255.255.0"
-GatewayAddress "10.60.1.1" -PrimaryDNSAddress "10.60.1.100" -SecondaryDNSAddress "10.60.1.101" -DNSSuffix
"corp.local" -DNSSearchSuffix "corp.local" -IPRanges $DefinedRange1,$DefinedRange2
RELATED LINKS
SYNOPSIS
Create a vRA external network profile
SYNTAX
New-vRAExternalNetworkProfile [-Name] <String> [[-Description] <String>] [-SubnetMask] <String> [[-GatewayAddress]
<String>] [[-PrimaryDNSAddress] <String>] [[-SecondaryDNSAddress] <String>] [[-DNSSuffix] <String>]
[[-DNSSearchSuffix] <String>] [[-IPRanges] <PSObject[]>] [[-PrimaryWinsAddress] <String>] [[-SecondaryWinsAddress]
<String>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Create a vRA external network profile
PARAMETERS
-Name <String>
The network profile Name
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Description <String>
The network profile Description
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SubnetMask <String>
The subnet mask of the network profile
Required? true
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-GatewayAddress <String>
The gateway address of the network profile
Required? false
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PrimaryDNSAddress <String>
The address of the primary DNS server
Required? false
Position? 5
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecondaryDNSAddress <String>
The address of the secondary DNS server
Required? false
Position? 6
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DNSSuffix <String>
The DNS suffix
Required? false
Position? 7
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DNSSearchSuffix <String>
The DNS search suffix
Required? false
Position? 8
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IPRanges <PSObject[]>
An array of ip address ranges
Required? false
Position? 9
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PrimaryWinsAddress <String>
The address of the primary wins server
Required? false
Position? 10
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecondaryWinsAddress <String>
The address of the secondary wins server
Required? false
Position? 11
Default value
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
PSCustomObject
OUTPUTS
System.Management.Automation.PSObject
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>$DefinedRange1 = New-vRANetworkProfileIPRangeDefinition -Name "External-Range-01" -Description "Example 1"
-StartIPv4Address "10.60.1.2" -EndIPv4Address "10.60.1.5"
$DefinedRange2 = New-vRANetworkProfileIPRangeDefinition -Name "External-Range-02" -Description "Example 2"
-StartIPv4Address "10.60.1.10" -EndIPv4Address "10.60.1.20"
New-vRAExternalNetworkProfile -Name Network-External -Description "External" -SubnetMask "255.255.255.0"
-GatewayAddress "10.60.1.1" -PrimaryDNSAddress "10.60.1.100" -SecondaryDNSAddress "10.60.1.101" -DNSSuffix
"corp.local" -DNSSearchSuffix "corp.local" -IPRanges $DefinedRange1,$DefinedRange2
RELATED LINKS