[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Removes an existing call admission control (CAC) subnet.


Remove-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description




The unique subnet ID of the subnet you want to remove. This value will be either an IP address (such as or a URL beginning with http: or https:.




Prompts you for confirmation before executing the command.




Describes what would happen if you executed the command without actually executing the command.

Detailed Description

A subnet is used to associate an endpoint with a network site for the purposes of determining location and limiting bandwidth. Each subnet must be associated with a CAC network site. Use this cmdlet to remove a subnet.

Return Types

This cmdlet does not return a value. It removes an object of type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.


-------------------------- Example 1 --------------------------

Copy Code
Remove-CsNetworkSubnet -Identity

This example removes the subnet with the Identity (the Subnet ID)

-------------------------- Example 2 --------------------------

Copy Code
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Remove-CsNetworkSubnet

Example 2 removes all subnets associated with the Vancouver site. To do this, we begin by calling the Get-CsNetworkSubnet cmdlet. This will retrieve a collection of all subnets defined within the Microsoft Communications Server 2010 deployment. This collection of subnets is then piped to the Where-Object cmdlet. Where-Object takes that collection and narrows it down to only those subnets with a NetworkSiteID equal to (-eq) Vancouver. Now that the collection consists only of subnets associated with the Vancouver site, we pipe the collection to Remove-CsNetworkSubnet, which removes every item in the collection.