New-CsNetworkRegion

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Создает новую область сети. Области сети представляют собой сетевые концентраторы или магистрали в корпоративной сети. Данный командлет впервые появился в Lync Server 2010.

New-CsNetworkRegion -NetworkRegionID <String> <COMMON PARAMETERS>
New-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> <COMMON PARAMETERS>
COMMON PARAMETERS: -CentralSite <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

В этом примере создается новый регион сети NorthAmerica. Имя области указано в значении параметра Identity. Также указано значение для необязательного параметра Description, в котором эта область описывается фразой "Все страны в Северной Америке" ("All North American Locations"). Наконец, параметр CentralSite получает значение имени сайта для этой области, Redmond-NA-MLS.

New-CsNetworkRegion -Identity NorthAmerica -Description "All North American Locations" -CentralSite Redmond-NA-MLS

В этом примере создается новый регион сети под названием EMEA с параметрами альтернативного маршрута голосовых данных. Для этого вызывается командлет New-CsNetworkRegion , в котором в качестве свойства Identity указывается значение EMEA. Также назначается значение обязательному параметру CentralSite (в данном примере имя сайта для этой области равно Dublin-EU-Site), а затем задается значение параметра AudioAlternatePath равное $False, которое указывает, что при недоступности необходимой пропускной способности голосовые вызовы не направляются по альтернативному маршруту, а просто не завершаются.

New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -AudioAlternatePath $False

В этом примере создается такой же регион сети, как и в примере 2. Однако в данном случае альтернативный маршрут определяется с помощью параметра BWAlternatePaths, а не AudioAlternatePath. В первой строке примера вызывается командлет New-CsNetworkBWAlternatePath , который создает новый альтернативный маршрут. Альтернативный маршрут имеет только два свойства: BWPolicyModality, которое может иметь значение audio или video (в данном примере audio), и AlternatePath, которое может иметь значение True или False (в данном примере False). Вывод этого командлета (ссылка на только что созданный объект альтернативного маршрута) назначается переменной $a.

В строке 2 этого примера новый альтернативный маршрут используется при создании нового региона сети. Для этого вызывается командлет New-CsNetworkRegion , в котором в качестве свойства Identity указывается значение EMEA. Также назначается значение обязательному параметру CentralSite (в данном примере имя сайта для этого региона равно Dublin-EU-Site), а затем задается значение параметра BWAlternatePaths, в который передается переменная ($a), содержащая только что созданный объект альтернативного маршрута.

$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $False
New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -BWAlternatePaths $a

Регион сети соединяет различные участки сети, расположенные в разных географических зонах. Каждый регион сети должен быть связан с сайтом; сайт — это сайт центра обработки данных, на котором выполняется служба политики пропускной способности, обеспечивающая контроль допуска звонков (CAC). Этот командлет позволяет создать новый регион сети. В параметрах этого командлета можно указать настройки, определяющие, включены ли альтернативные маршруты через Интернет для голосовых и видеовызовов, а также задать автоматическое создание идентификатора обходящего вызова.

По умолчанию право на локальный запуск командлета New-CsNetworkRegion имеют члены группы RTCUniversalServerAdmins. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которым назначен этот командлет (включая все самостоятельно созданные роли RBAC), выполните в командной строке Windows PowerShell следующую команду:

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

 

Параметр Обязательный? Тип Описание

CentralSite

Обязательный?

System.String

Центральный сайт, на котором выполняется служба политики пропускной способности. Эта служба должна быть включена для использования контроля допуска звонков. Она выполняется на сервере переднего плана или Standard Edition.

Identity

Обязательный?

Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity

Уникальный идентификатор для созданного региона сети. Регионы создаются только в глобальной области действия, поэтому в этом идентификаторе область действия не указывается. Вместо этого в нем содержится строка, являющаяся уникальным именем для идентификации данного региона.

NetworkRegionID

Обязательный?

System.String

Это значение совпадает со значением Identity. Нельзя указать и Identity, и NetworkRegionID. Значение, указанное для одного свойства, автоматически будет использоваться для обоих.

AudioAlternatePath

Необязательный

System.Boolean

Этот параметр определяет, будут ли голосовые звонки перенаправляться по альтернативному пути, если пропускной способности основного пути недостаточно.

С помощью этого параметра задается значение свойства BWAlternatePaths. Значение, переданное параметру, присваивается свойству AlternatePath элемента альтернативного пути, свойство BWPolicyModality которого имеет значение Audio.

Если указать значение для этого параметра, нельзя будет указать значение для параметра BWAlternatePaths.

Значение по умолчанию: True. Значение False для этого параметра следует задавать только в том случае, если требуется отключить разгрузку в Интернет. Если какие-либо вызовы будут вызовами по Интернету, это значение должно быть равным True, независимо от параметров пропускной способности.

BWAlternatePaths

Необязательный

System.Management.Automation.PSListModifier

Список объектов, содержащих сведения о том, допустимы ли альтернативные маршруты через Интернет, когда мультимедийный запрос не может быть выполнен через предпочтительный маршрут (например, при превышении ограничений для этого маршрута). Объекты альтернативных маршрутов можно создавать с помощью командлета New-CsNetworkBWAlternatePath .

Если указать значение этого параметра, задать значения параметра AudioAlternatePath или VideoAlternatePath будет нельзя.

По умолчанию альтернативные маршруты для голосовых и видеовызовов включены (AlternatePath = True).

BypassID

Необязательный

System.String

Глобальный уникальный идентификатор (GUID). Этот идентификатор GUID служит для сопоставления областей сети с параметрами обхода сервера-посредника в конфигурации контроля допуска звонков или службы Enhanced 9-1-1 (E9-1-1). (Используйте это значение BypassID при вызове командлета New-CsNetworkMediaBypassConfiguration .)

Если значение этого параметра не указано, оно будет создано автоматически. Если это значение указано, оно должно иметь формат GUID (например, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Рекомендуется использовать автоматическое создание. Если указать значение для этого параметра самостоятельно, появится запрос на подтверждение, действительно ли вы хотите самостоятельно указать это значение и не использовать автоматическое создание.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

Description

Необязательный

System.String

Строка с описанием области. С помощью этого параметра можно дать более понятное описание предназначения области, чем с помощью параметра Identity.

Force

Необязательный

System.Management.Automation.SwitchParameter

Отменяет вывод каких-либо запросов на подтверждение, которые в противном случае отображались бы перед внесением изменений. Например, если указать значение для параметра BypassID, запрос на подтверждение не выводится.

InMemory

Необязательный

System.Management.Automation.SwitchParameter

Создает ссылку на объект без фиксации объекта в качестве постоянного изменения. Если выходные данные этого командлета, вызванного с помощью указанного параметра, назначаются переменной, можно внести изменения в свойства ссылки на объект и затем зафиксировать эти изменения, вызвав соответствующий командлет Set-<cmdlet> .

VideoAlternatePath

Необязательный

System.Boolean

Этот параметр определяет, будут ли видеозвонки перенаправляться по альтернативному пути, если пропускной способности основного пути недостаточно.

С помощью этого параметра задается значение свойства BWAlternatePaths. Значение, переданное параметру, присваивается свойству AlternatePath элемента альтернативного пути, свойство BWPolicyModality которого имеет значение Video.

Если указать значение для данного параметра, то для параметра BWAlternatePaths значение задавать нельзя.

Значение по умолчанию: True. Значение False для этого параметра следует задавать только в том случае, если требуется отключить разгрузку в Интернет. Если какие-либо вызовы будут вызовами по Интернету, это значение должно быть равным True, независимо от параметров пропускной способности.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Описывает, что произойдет при выполнении команды без реального выполнения команды.

Создает объект типа Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType.

 
Показ: