New-CsNetworkMediaBypassConfiguration

Skype for Business Server 2015
 

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

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

New-CsNetworkMediaBypassConfiguration [-AlwaysBypass <$true | $false>] [-BypassID <String>] [-Enabled <$true | $false>] [-EnableDefaultBypassID <$true | $false>] [-EnabledForAudioVideoConferences <$true | $false>] [-ExternalBypassMode <Off | ICE | Any>] [-InternalBypassMode <Off | ICE | Any>]

Команды в данном примере разрешают обход сервера-посредника и настраивают выполнение попыток обхода в любом случае. В первой строке примера происходит вызов командлета New-CsNetworkMediaBypassConfiguration . Командлету передаются два параметра, AlwaysBypass и Enabled, оба со значением True ($true). Установка параметра Enabled в значение True разрешает обход сервера-посредника, установка параметра AlwaysBypass в значение True обеспечивает выполнение попыток обхода сервера-посредника для всех звонков. (Обратите внимание, что при установке этих двух параметров автоматически формируется значение для свойства BypassID.) Командлет New-CsNetworkMediaBypassConfiguration создает объект только в памяти, поэтому этот объект назначается переменной $a.

Конфигурация обхода мультимедиа хранится в параметрах конфигурации сети. Поэтому во второй строке примера изменения в параметрах конфигурации обхода сохраняются в конфигурации сети посредством вызова командлета Set-CsNetworkConfiguration , в который передается созданный в первой строке объект конфигурации обхода ($a) в качестве параметра MediaBypassSettings.

$a = New-CsNetworkMediaBypassConfiguration -AlwaysBypass $true -Enabled $true
Set-CsNetworkConfiguration -MediaBypassSettings $a

Командлета Set-CsNetworkMediaBypassConfiguration нет в Skype для бизнеса Server 2015, поэтому для изменения существующих настроек нужно либо создать новую конфигурацию (как показано в примере 1), чтобы заменить существующую конфигурацию, либо модифицировать настройки, сначала получив и изменив их с помощью командлета Set-CsNetworkConfiguration . Данный пример демонстрирует отключение параметра Always Bypass вторым способом.

В первой строке примера извлекаются существующие параметры обхода сервера-посредника. Это осуществляется вызовом командлета Get-CsNetworkConfiguration . Вызов данного командлета заключен в скобки, чтобы он выполнялся до запуска других частей команды. Командлет Get-CsNetworkConfiguration извлекает параметры для всей конфигурации сети. Чтобы получить только параметры обхода сервера-посредника, указывается свойство MediaBypassSettings. Эти параметры назначаются переменной $a.

Во второй строке выполняется изменение параметров, сохраненных в переменной $a, путем присваивания значения False ($false) свойству AlwaysBypass. В третьей строке вызывается командлет Set-CsNetworkConfiguration , при этом в параметр MediaBypassSettings передается переменная $a, и таким образом сохраняются изменения, сделанные в свойстве AlwaysBypass.

$a = (Get-CsNetworkConfiguration).MediaBypassSettings
$a.AlwaysBypass = $false
Set-CsNetworkConfiguration -MediaBypassSettings $a

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

В отличие от большинства командлетов New- в Skype для бизнеса Server 2015, данный командлет не сразу сохраняет новую конфигурацию: он создает настройки только в памяти. Объект, созданный данным командлетом, должен быть сохранен в переменную и затем передан в качестве параметра MediaBypassSettings конфигурации сети. (Дополнительные сведения смотри в подразделе с примерами.)

Настройки, созданные данным командлетом, могут быть получены только при обращении к свойству MediaBypassSettings глобальной конфигурации сети. Чтобы получить данные настройки, запустите команду: (Get-CsNetworkConfiguration).MediaBypassSettings.

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

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

 

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

AlwaysBypass

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

Boolean

Установка данному параметру значения True приведет к выполнению попыток обхода для всех звонков.

Задавайте данному параметру значение True только в том случае, если отключен контроль допуска звонков (CAC). Задавайте данному параметру значение True только для развертываний, где:

- не требуется контроль за пропускной способностью канала;

- не требуется выполнять сложный контроль, когда должен происходить обход;

- между клиентами и шлюзами есть подключение.

Если параметру Enabled задано значение True, а параметру AlwaysBypass — значение False, логика выполнения обхода будет использовать сайты и регионы конфигурации сети для определения возможности выполнения обхода.

Если задать параметру AlwaysBypass значение True и при этом также не задать параметру Enabled значение True, то отображается сообщение: "Параметр AlwaysBypass игнорируется, если значение параметра Enabled равно false".

Если установить параметрам AlwaysBypass и Enabled значение True, то идентификатор обхода будет сформирован автоматически и сохранен в свойстве BypassID.

Значение по умолчанию: False

BypassID

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

String

Идентификатор обхода мультимедиа. Если для данного параметра задано значение, а параметр AlwaysBypass имеет значение True, то данный идентификатор BypassID будет назначен всем подсетям. Если параметр AlwaysBypass имеет значение False, то значение BypassID назначается всем подсетям, не указанным в сайтах и регионах конфигурации сети.

Данный идентификатор должен иметь формат GUID (например, 96f14dea-5170-429a-b92b-f1cb909c4bb6). Но обычно вам не потребуется задавать или изменять данный параметр. Его значение формируется автоматически при задании параметру Enabled значения True и либо: 1) задании параметру AlwaysBypass значения True, 2) или задании параметру EnableDefaultBypassID значения True.

Enabled

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

Boolean

Установите данному параметру значение True, чтобы разрешить обход мультимедиа. С этого момента решения о выполнении обхода будут приниматься на основе значения параметра AlwaysBypass следующим образом:

- если параметр AlwaysBypass имеет значение True, попытки обхода выполняются для всех звонков.

- если параметр AlwaysBypass имеет значение False, то для определения возможности выполнения обхода используются сайт и регион конфигурации сети.

Значение по умолчанию: False

EnableDefaultBypassID

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

Boolean

Данное значение применяется, только если параметру AlwaysBypass задано значение False.

Установка данному параметру значения True приведет к автоматическому формированию идентификатора обхода по умолчанию. Это автоматически созданное значение будет сохранено в свойстве BypassID.

Этот параметр полезно использовать, когда имеется хорошо связанное ядро сети и удаленные сайты с ограниченными по пропускной способности каналами. Администратору потребуется указать только подсети, связанные с удаленными сайтами, с помощью сайтов и регионов конфигурации сети. Не требуется определять подсети, связанные с ядром сети, и попытки обхода между этими подсетями будут выполняться автоматически.

Значение по умолчанию: False

EnabledForAudioVideoConferences

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

Boolean

Указывает, должен ли использоваться обход мультимедиа для аудио или видеоконференций. Значение по умолчанию — False ($False).

ExternalBypassMode

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

BypassModeEnumType

Зарезервировано для будущего использования. Внешний обход мультимедиа не поддерживается в Skype для бизнеса Server 2015.

По умолчанию: Off

InternalBypassMode

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

BypassModeEnumType

Значение данного параметра управляет возможностью клиентов, подключаемых изнутри сети организации, выполнять обход мультимедиа. Если параметру Enabled задано значение True, то данное значение будет автоматически изменено на Any. Другие значения данного параметра зарезервированы для будущего использования.

По умолчанию: Off

Создает ссылку на объект типа Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.MediaBypassSettingsType.

 
Показ: