Parameters

A network region interconnects various parts of a network across multiple geographic areas. Every network region must be associated with a central site. The central site is the data center site on which the call admission control (CAC) bandwidth policy service is running. Use this cmdlet to modify an existing network region, including settings that determine whether alternate paths are allowed for audio and video connections, and that associate the sites within the region with a media bypass configuration.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Set-CsNetworkRegion cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkRegion\b"}

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType object. Accepts pipelined input of network region objects.

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

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

	Copy Code
Set-CsNetworkRegion -Identity NorthAmerica -Description "North American Region"

In this example the network region named NorthAmerica is modified. The Description parameter is given a value of "North American Region." If a Description existed on the NorthAmerica region, this command overwrites it with this value. If no Description had been set, this command sets it.

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

	Copy Code
Set-CsNetworkRegion -Identity EMEA -VideoAlternatePath $False

This example modifies the network region named EMEA and gives it a new video alternate path setting. To do this we call Set-CsNetworkRegion, passing an Identity of EMEA. We then specify the VideoAlternatePath parameter, passing the value $False. Setting VideoAlternatePath to False indicates that if adequate bandwidth is not available, the video call will not be routed to an alternate path; instead, it will simply not be completed.

-------------------------- Example 3 --------------------------

	Copy Code
$a = Get-CsNetworkRegion -Identity NorthAmerica $a.BWAlternatePaths | foreach {Set-CsNetworkRegion -Identity Asia -BWAlternatePaths @{add=$_}}

Example 3 assigns the same set of alternate path settings to the Asia network region that has been set for the NorthAmerica region. The first line in this example retrieves an instance of the network region NorthAmerica and assigns it to variable $a. The second line begins by retrieving the contents of the BWAlternatePaths property or the NorthAmerica region (stored in variable $a): $a.BWAlternatePaths. This will be a collection of all the alternate path settings in the NorthAmerica region.

The next thing we do is pipe that collection of settings to the foreach function. Foreach will cycle through the collection one item at a time, performing the actions in the following curly braces. In this case the action is to call Set-CsNetworkRegion with an Identity of Asia to set the properties of the Asia region. The next parameter is BWAlternatePaths. We pass the value @{add=$_} to this parameter. The variable $_ represents the current item in the collection, in this case the current alternate path. The @{add=} portion of the value adds that item to the collection of BWAlternatePaths for the Asia region.

Other Resources