Edit

Share via


Get-CsTenantNetworkRegion

Returns information about the network region setting in the tenant. Tenant network region is used for Location Based Routing.

Syntax

Identity (Default)

Get-CsTenantNetworkRegion
    [[-Identity] <string>]
    [<CommonParameters>]

Filter

Get-CsTenantNetworkRegion
    [-Filter <string>]
    [<CommonParameters>]

Description

A network region interconnects various parts of a network across multiple geographic areas.

A network region contains a collection of network sites. For example, if your organization has many sites located in India, then you may choose to designate "India" as a network region.

Location-Based Routing is a feature that allows PSTN toll bypass to be restricted for users based on policy and the user's geographic location at the time of an incoming or outgoing PSTN call.

Location-Based Routing leverages the same network regions, sites, and subnets concept that is available in Skype for Business Server. It is now available in Microsoft 365 for Teams clients. For toll bypass restricted locations, each IP subnet and PSTN gateway for that location are associated to a network site by the administrator. A user's location is determined by the IP subnet which the user's Teams endpoint(s) is connected to at the time of a PSTN call. A user may have multiple Teams clients located at different sites, in which case Location-Based Routing will enforce each client's routing separately depending on the location of its endpoint.

Examples

Example 1

PS C:\> Get-CsTenantNetworkRegion

The command shown in Example 1 returns the list of network regions for the current tenant.

Example 2

PS C:\> Get-CsTenantNetworkRegion -Identity RedmondRegion

The command shown in Example 2 returns the network region within the scope of RedmondRegion.

Parameters

-Filter

The Filter parameter allows you to limit the number of results based on filters you specify.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Filter
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

The Identity parameter is a unique identifier that designates the scope. It specifies the collection of tenant network region to be returned.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Identity
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

System.Object