Set-CsNetworkRegion

Skype for Business Server 2015
 

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

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

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

В этом примере изменяется область сети с именем NorthAmerica. Для параметра Description задается значение "North American Region" (Североамериканский регион). Если для области NorthAmerica свойство Description было задано, эта команда перезапишет его значение. Если же свойство Description не имело значения, команда задаст его.

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

В этом примере изменяется область сети с именем EMEA, для которой задается новое значение параметра альтернативного пути видеозвонков. Для этого вызывается командлет Set-CsNetworkRegion , которому передается идентификатор EMEA. Затем указывается параметр VideoAlternatePath, которому передается значение $False. Присваивая свойству VideoAlternatePath значение False, мы указываем, что если пропускной способности недостаточно, видеозвонки не будут перенаправляться по альтернативному пути. Вместо этого они просто не будут выполняться.

Set-CsNetworkRegion -Identity EMEA -VideoAlternatePath $False

В примере 3 для области сети Asia задается такой же набор параметров альтернативного пути, что и для области NorthAmerica. В первой строке примера извлекается экземпляр области сети NorthAmerica, который присваивается переменной $a. Во второй строке сначала извлекается содержимое свойства BWAlternatePaths области NorthAmerica (хранящейся в переменной $a): $a.BWAlternatePaths. Оно представляет собой коллекцию параметров альтернативного пути для области NorthAmerica.

Затем эта коллекция параметров передается в функцию foreach. Функция foreach выполняет циклический перебор элементов коллекции, выполняя для каждого из них действия, указанные в фигурных скобках. В данном случае вызывается командлет Set-CsNetworkRegion с параметром Identity, для которого задано значение Asia. Таким образом указывается, что необходимо настроить свойства региона Asia. Следующий параметр — BWAlternatePaths. Ему передается значение @{add=$_}. Переменная $_ представляет текущий элемент коллекции, в данном случае текущий альтернативный путь. Часть @{add=} служит для добавления данного элемента в коллекцию BWAlternatePaths для области Asia.

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

Область сети связывает части сети, расположенные в различных географических районах. Каждая область сети должна быть связана с центральным сайтом. Центральный сайт — это сайт центра обработки данных, на котором выполняется служба политики пропускной способности для контроля допуска звонков. С помощью этого командлета можно изменить существующую область сети, включая параметры, которые определяют, разрешены ли альтернативные пути для звуковых и видеоподключений, а также связывают сайты внутри региона с помощью конфигурации обхода сервера-посредника.

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

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

 

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

AudioAlternatePath

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

Boolean

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

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

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

Если какой-либо из ваших вызовов будет звонком через Интернет, значение должно быть равно True независимо от параметров пропускной способности.

BWAlternatePaths

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

PSListModifier

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

BypassID

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

String

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

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

CentralSite

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

String

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

Confirm

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

SwitchParameter

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

Description

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

String

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

Force

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

SwitchParameter

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

Identity

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

XdsGlobalRelativeIdentity

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

Instance

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

PSObject

Ссылка на объект области сети. Этот объект должен иметь тип Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType. Его можно получить с помощью командлета Get-CsNetworkRegion .

VideoAlternatePath

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

Boolean

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

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

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

Если какой-либо из ваших вызовов будет звонком через Интернет, значение должно быть равно True независимо от параметров пропускной способности.

WhatIf

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

SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType. Принимает из конвейера объекты областей сети.

Этот командлет не возвращает значения. Он изменяет объект типа Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType.

 
Показ: