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

Modifies an existing call admission control (CAC) subnet.

Syntax


Set-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]


Set-CsNetworkSubnet [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
Identity	Optional	XdsGlobalRelativeIdentity	The unique subnet ID of the subnet you want to modify. 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.
Description	Optional	String	A description of the subnet being modified.
Instance	Optional	PSObject	A reference to a network subnet object that you want to modify. This object must be of type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType, which can be retrieved by calling Get-CsNetworkSubnet.
MaskBits	Optional	Int32	The bitmask to be applied to the subnet being modified.
NetworkSiteID	Optional	String	The site ID of the site to which this subnet is to be applied. You can retrieve site IDs for your deployment by calling the Get-CsNetworkSite cmdlet.
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 modify the associated network site, change the description of the subnet, or modify the mask bits for the subnet.

Return Types

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

Examples

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

	Copy Code
Set-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 25 -NetworkSiteID Chicago

This example modifies the subnet with the Identity (the Subnet ID) 172.11.15.0. The subnet is modified with a new MaskBits value (25) and a new NetworkSiteID (Chicago).

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

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

Example 2 moves all subnets on the Vancouver site to the Chicago 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 Set-CsNetworkSubnet. We supply one parameter to Set-CsNetworkSubnet: NetworkSiteID. By passing the parameter a value of Chicago, we’re instructing Set-CsNetworkSubnet to change the network site ID of every member of the collection to Chicago.