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

Creates new settings that define whether media can be routed to alternate paths for bandwidth-constrained connections.

Syntax

New-CsNetworkBWAlternatePath -AlternatePath <$true | $false> -BWPolicyModality <Audio | Video>

Parameters

Parameter Required Type Description

AlternatePath

Required

Boolean

Set the parameter to True to allow calls made in the media of the modality specified in the BWPolicyModality parameter (either audio or video) to be routed through an alternate path if adequate bandwidth does not exist in the primary path.

BWPolicyModality

Required

BWPolicyModality

The modality to which the alternate path setting applies.

Valid values: audio, video

Full data type: Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyModality

Detailed Description

Within a call admission control (CAC) configuration in Microsoft Communications Server 2010 there are two possible modalities: audio and video. Bandwidth limitations can be set on each of these modalities. When bandwidth limitations will prevent a call from completing, it may be possible for the call to take an alternate path through the network that will allow the call to be completed. This cmdlet allows you to create the settings that define whether a call can be routed through an alternate path based on modality. The settings apply per region within the CAC configuration.

This cmdlet does not immediately save the newly-created settings. Instead, it creates the settings in memory. You need to assign the output of the cmdlet to a variable, then use that variable to apply these settings to a region within the network.

Return Types

Creates an object of type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWAlternatePathType.

Examples

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

Copy Code
$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $true
New-CsNetworkRegion -Identity NorthAmerica -CentralSite Redmond-NA-MCS -BWAlternatePaths $a

This example creates a new network bandwidth alternate path and assigns those settings to a newly-created region. The first line in the example calls the New-CsNetworkBWAlternatePath cmdlet to create a new alternate path. An alternate path has only two properties: BWPolicyModality, which must be set to either audio or video (audio in this example); and AlternatePath, which must be either True or False (True [$true] in this example). We assign the output from this cmdlet, a reference to the alternate path object just created, to the variable $a.

In line 2 of this example we use this newly-created alternate path in the creation of a new network region. To do this we call New-CsNetworkRegion, passing an Identity of NorthAmerica. We assign a value for the required parameter CentralSite (in this example the name of the central site for this region is Redmond-NA-MCS), then we specify the BWAlternatePaths parameter, passing it the variable ($a) containing the alternate path object we just create.