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

Removes an existing call admission control (CAC) subnet.

Syntax

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

Parameters

Parameter Required Type Description

Identity

Required

XdsGlobalRelativeIdentity

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

Confirm

Optional

SwitchParameter

Prompts you for confirmation before executing the command.

WhatIf

Optional

SwitchParameter

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.

Examples

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

Copy Code
Remove-CsNetworkSubnet -Identity 172.11.15.0

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

-------------------------- 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.