Edit

New-CsTenantNetworkRegion

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

As an admin, you can use the Teams PowerShell command, New-CsTenantNetworkRegion to define network regions. A network region interconnects various parts of a network across multiple geographic areas. The RegionID parameter is a logical name that represents the geography of the region and has no dependencies or restrictions. The organization's network region is used for Location-Based Routing.

Syntax

New-CsTenantNetworkRegion
   [-Identity] <string>
   [-BypassID <string>]
   [-CentralSite <string>]
   [-Description <string>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CsTenantNetworkRegion
   -NetworkRegionID <string>
   [-BypassID <string>]
   [-CentralSite <string>][-Description <string>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Location-Based Routing leverages the same network regions, sites, and subnets concept that is available in Skype for Business Server. A network region contains a collection of network sites. For example, if your organization has many sites located in Redmond, then you may choose to designate "Redmond" as a network region.

Examples

Example 1

PS C:\> New-CsTenantNetworkRegion -NetworkRegionID "RegionA"

The command shown in Example 1 creates the network region 'RegionA' with no description. Identity and CentralSite will both be set identically to NetworkRegionID.

Parameters

-BypassID

This parameter is not used.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CentralSite

This parameter is not used.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Provide a description of the network region to identify purpose of creating it.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Identity

Unique identifier for the network region to be created.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NetworkRegionID

The name of the network region. This must be a string that is unique. You cannot specify an NetworkRegionID and an Identity at the same time.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.Object