Remove-AzureRmVirtualNetworkSubnetConfig

NAME Remove-AzureRmVirtualNetworkSubnetConfig



SYNOPSIS

Removes a subnet configuration from a virtual network.





SYNTAX

Remove-AzureRmVirtualNetworkSubnetConfig [-DefaultProfile <IAzureContextContainer>] [-Name <String>] -VirtualNetwork <PSVirtualNetwork>

[<CommonParameters>]





DESCRIPTION

The Remove-AzureRmVirtualNetworkSubnetConfig cmdlet removes a subnet from an Azure virtual network.





PARAMETERS

-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

Specifies the name of the subnet configuration to remove.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-VirtualNetwork <PSVirtualNetwork>

Specifies the VirtualNetwork object that contains the subnet configuration to remove.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

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 (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

PSVirtualNetwork

Parameter 'VirtualNetwork' accepts value of type 'PSVirtualNetwork' from the pipeline





OUTPUTS

Microsoft.Azure.Commands.Network.Models.PSVirtualNetwork







NOTES









1: Remove a subnet from a virtual network and update the virtual network



New-AzureRmResourceGroup -Name TestResourceGroup -Location centralus

$frontendSubnet = New-AzureRmVirtualNetworkSubnetConfig -Name frontendSubnet

-AddressPrefix "10.0.1.0/24"



$backendSubnet = New-AzureRmVirtualNetworkSubnetConfig -Name backendSubnet -AddressPrefix

"10.0.2.0/24"



$virtualNetwork = New-AzureRmVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName

TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet

$frontendSubnet,$backendSubnet



Remove-AzureRmVirtualNetworkSubnetConfig -Name backendSubnet -VirtualNetwork

$virtualNetwork

$virtualNetwork | Set-AzureRmVirtualNetwork



This example creates a resource group and a virtual network with two subnets. It then uses the Remove-AzureRmVirtualNetworkSubnetConfig

command to remove the backend subnet from the in-memory representation of the virtual network. Set-AzureRmVirtualNetwork is then called

to modify the virtual network on the server side.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... bnetconfig

Add-AzureRmVirtualNetworkSubnetConfig

Get-AzureRmVirtualNetworkSubnetConfig

New-AzureRmVirtualNetworkSubnetConfig

Set-AzureRmVirtualNetworkSubnetConfig