Set-CsTrunkConfiguration

Skype for Business Server 2015
 

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

Изменяет существующую магистральную конфигурацию, которая описывает настройки для магистрального объекта, такого как шлюз телефонной сети общего пользования (PSTN), PBX с поддержкой IP или пограничный контроллер сеансов (SBC) у поставщика услуг. Данный командлет впервые появился в Lync Server 2010.

Set-CsTrunkConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsTrunkConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enable3pccRefer <$true | $false>] [-EnableBypass <$true | $false>] [-EnableFastFailoverTimer <$true | $false>] [-EnableLocationRestriction <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnableOnlineVoice <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableRTPLatching <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-ForwardCallHistory <$true | $false>] [-ForwardPAI <$true | $false>] [-MaxEarlyDialogs <UInt32>] [-NetworkSiteID <String>] [-OutboundCallingNumberTranslationRulesList <PSListModifier>] [-OutboundTranslationRulesList <PSListModifier>] [-PstnUsages <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]

В этом примере магистральная конфигурация с удостоверением site:Redmond меняется для включения обхода мультимедиа. Это достигается за счет присвоения значения $True параметру EnableBypass. Оставшиеся свойства этой конфигурации сохраняют имеющиеся значения.

Set-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True

В этом примере изменяется правило исходящего преобразования, заданное для магистральной конфигурации с удостоверением site:Redmond. Обратите внимание, что для применения этого изменения командлет Set-CsTrunkConfiguration фактически не вызывается. Изменения в Set-CsOutboundTranslationRule автоматически отражаются в магистральной конфигурации с удостоверением, соответствующим части с областью действия удостоверения правила исходящего преобразования.

Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation '$1'

В примере 3 для свойства SRTPMode для всех магистральных конфигураций, определенных в области действия сайта, задается значение "Optional". Первая часть команды — это вызов командлета Get-CsTrunkConfiguration , который использует параметр Filter для получения всех магистральных конфигураций с удостоверением, которое начинается с "site:", т. е. всех конфигураций, заданных на уровне сайта. Эта коллекция конфигураций затем передается в командлет Set-CsTrunkConfiguration , который задает для свойства SRTPMode каждой конфигурации значение "Optional".

Get-CsTrunkConfiguration -Filter site:* | Set-CsTrunkConfiguration -SRTPMode "Optional"

В примере 4 магистральная конфигурация с удостоверением site:Redmond меняется для включения поддержки PIDF-LO. По умолчанию параметр EnablePIDFLOSupport имеет значение False. В этом примере мы установили значение True, чтобы включить поддержку расположения для экстренных вызовов. Необходимо установить для EnablePIDFLOSupport значение True, чтобы сведения о расположении отправлялись в магистраль приложением исходящей маршрутизации.

Set-CsTrunkConfiguration -Identity site:Redmond -EnablePIDFLOSupport $True

Используйте этот командлет для изменения магистральной конфигурации, применяемой к объектам шлюза PSTN. Каждая конфигурация содержит определенные параметры для магистрального объекта, такого как шлюз PSTN, IP-PBX или SBC у поставщика услуг. Эти параметры управляют, например, тем, включен ли обход мультимедиа в этой магистрали, отправляются пакеты RTCP в определенных условиях и следует ли использовать шифрование SRTP.

 

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

ConcentratedTopology

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

Логическое

Значение этого параметра определяет, существует ли известная оконечная точка мультимедиа. (Примером такой точки служит шлюз PSTN, где у точки завершения мультимедиа такой же IP-адрес, что и сигнальной точки завершения.) Присвойте этому параметру значение False, если у магистрали нет известной точки завершения мультимедиа.

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

Confirm

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

SwitchParameter

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

Description

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

Строка

Строка, описывающая назначение магистральной конфигурации.

Enable3pccRefer

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

Логическое

Указывает, можно ли использовать протокол 3pcc, чтобы разрешить переключенным звонкам обходить размещенный сайт. 3pcc также называют "протоколом третьего лица". Он используется, когда третье лицо привлекается для соединения пары звонящих (например, оператор производит вызов от лица А к лицу B). Метод REFER — это стандартный SIP-метод, который указывает, что получатель должен связаться с третьим лицом с помощью информации, предоставленной отправителем. По умолчанию используется значение False ($False).

EnableBypass

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

Логическое

Значение этого параметра определяет, включен ли обход мультимедиа для этой магистрали. Установите для параметра значение True, чтобы включить обход. Учтите, что для успешной работы обхода мультимедиа шлюзы PSTN, контроллеры SBC и PBX должны поддерживать определенные возможности, в том числе следующие:

- возможность получения разделенных ответов в приглашении;

- клиенты Skype для бизнеса и точка завершения мультимедиа должны иметь возможность для взаимодействия напрямую без прохода через посредник;

- подсеть шлюза должна быть определена на том же сайте, что и подсеть клиента; при использовании разных сайтов они не должны быть разделены каналами WAN с ограниченной пропускной полосой.

Обход мультимедиа можно включать только при следующих обстоятельствах:

- Для параметра ConcentratedTopology задано значение True

- Для параметра EnableReferSupport задано значение False, для RTCPActiveCalls и RTCPCallsOnHold — False, либо для EnableReferSupport задано значение True

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

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

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

EnableFastFailoverTimer

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

Логическое

Если установлено значение True, исходящие вызовы, ответ шлюза для которых не был получен в течение 10 секунд, будут направляться на следующий доступный магистральный канал; при отсутствии дополнительных магистральных каналов вызов автоматически сбрасывается. В организации с низкой скоростью сети и ответа шлюза это может приводить к сбросу вызовов без необходимости.

Значение по умолчанию — True.

EnableLocationRestriction

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

Логическое

Если задано значение True, будет включена маршрутизация голосовых вызовов на основе расположения для вызовов, передаваемых по магистралям SIP, управляемым указанной коллекцией параметров конфигурации магистрали SIP. Маршрутизация голосовых вызовов на основе расположения позволяет учитывать и вызывающих, и вызываемых пользователей при маршрутизации вызовов. Если для этого свойства задано значение True (значение по умолчанию — False), необходимо также задать свойство NetworkSiteId.

EnableMobileTrunkSupport

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

Логическое

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

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

EnableOnlineVoice

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

Логическое

Указывает, поддерживают ли магистрали SIP передачу голоса через Интернет. При этом у пользователей есть локальная учетная запись Lync Server, но их голосовая почта размещается в Skype для бизнеса Online. По умолчанию используется значение False ($False).

EnablePIDFLOSupport

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

Логическое

Определяет, следует ли направлять экстренные вызовы с объектом PIDF-LO через заданный шлюз. Установите для этого параметра значение True, если экстренные вызовы необходимо направлять сертифицированному поставщику экстренных услуг. (Данные о расположении передаются вместе с вызовом.)

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

EnableReferSupport

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

Логическое

Определяет, поддерживает ли эта магистраль запросы Refer от посредник.

Обход мультимедиа можно включать только при следующих обстоятельствах:

- Для параметра ConcentratedTopology задано значение True

- Для параметра EnableReferSupport задано значение False, для RTCPActiveCalls и RTCPCallsOnHold — False, либо для EnableReferSupport задано значение True

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

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

EnableRTPLatching

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

Логическое

Указывает, поддерживают ли магистрали SIP запирание RTP, технологию, которая обеспечивает связь RTP/RTCP через устройство NAT или брандмауэр. Значение по умолчанию — False ($False).

EnableSessionTimer

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

Логическое

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

Обратите внимание, что даже если для этого параметра задано значение False, таймеры сеанса могут использоваться, если таймер сеанса удаленного соединения включен. В этом случае посредник ответит на пробы таймера сеанса из удаленного объекта.

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

EnableSignalBoost

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

Логическое

Если для этого параметра задано значение True, шлюз PSTN, IP-PBX и контроллер SBC у поставщика услуг увеличат громкость звука голосовых потоков, отправляемых клиентам посредник и Skype для бизнеса Server 2015. Если значение равно False, громкость звука будет увеличена для посредник (для вызовов без обхода) или в клиентах Skype для бизнеса Server 2015 (для вызовов с обходом).

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

Force

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

SwitchParameter

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

ForwardCallHistory

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

Логическое

Указывает, перенаправляется ли журнал вызовов через магистраль. По умолчанию используется значение False ($False).

ForwardPAI

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

Логическое

Указывает, перенаправляется ли заголовок P-Asserted-Identity (PAI) вместе с вызовом. Заголовок PAI позволяет проверить личность звонящего. По умолчанию используется значение False ($False).

Identity

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

XdsIdentity

Уникальный идентификатор, включающий область действия магистральной конфигурации. Магистральные конфигурации могут существовать на глобальном уровне, уровне сайта или службы шлюза PSTN. Например, site:Redmond (для сайта) или PstnGateway:Redmond.litwareinc.com (для службы).

Instance

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

TrunkConfiguration

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

Для этого параметра следует указать объект типа Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration, который можно извлечь с помощью командлета Get-CsTrunkConfiguration .

MaxEarlyDialogs

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

UInt32

Максимальное число разделенных ответов, которое может получать шлюз PSTN, IP-PBX или контроллер SBC у поставщика услуг в приглашении, отправленном в посредник.

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

NetworkSiteID

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

Строка

ИД сайта сети связан с коллекцией параметров конфигурации магистрали. Если для свойства EnableLocationRestriction задано значение True, маршрутизация голосовых вызовов на основе расположения по этой магистрали будет управляться с помощью параметров, настроенных для указанного сайта. ИД сайта сети можно получить с помощью этой команды:

Get-CsNetworkSite | Select NetworkSiteID

OutboundCallingNumberTranslationRulesList

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

PSListModifier

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

Get-CsOutboundCallingNumberTranslationRule

OutboundTranslationRulesList

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

PSListModifier

Коллекция правил преобразования телефонных номеров, которые применяются к вызовам, обрабатываемым исходящей маршрутизацией (вызовы, направляемые в PBX и PSTN).

Хотя этот список и эти правила можно изменить непосредственно с помощью этого командлета, рекомендуется изменить правила преобразования исходящих вызовов с помощью командлета Set-CsOutboundTranslationRule . Командлет Set-CsOutboundTranslationRule изменит правило, а эти изменения будут автоматически отражены в магистральной конфигурации. Чтобы изменить конфигурацию, добавив новое правило преобразования, вызовите командлет New-CsOutboundTranslationRule . Новое правило будет добавлено в магистральную конфигурацию с соответствующей областью действия.

PstnUsages

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

PSListModifier

Коллекция способов использования PSTN, назначенных магистрали. Вы можете получить информацию о доступных способах использования, выполнив эту команду:

Get-CsPstnUsage

RemovePlusFromUri

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

Логическое

Если задать для этого параметра значение True, посредник удалит начальные символы плюса (+) из универсальных кодов ресурсов (URI) перед их отправкой поставщику услуг.

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

RTCPActiveCalls

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

Логическое

Этот параметр определяет, отправляются ли пакеты RTCP из шлюза PSTN, IP-PBX или контроллера SBC у поставщика услуг для активных вызовов. В этом контексте активным вызовом является вызов, в котором разрешается передавать мультимедиа хотя бы в одном направлении. Если для RTCPActiveCalls задано значение True, посредник или клиент Skype для бизнеса Server 2015 могут завершить вызов, если не получит пакеты RTCP в течение 30 секунд.

Учтите, что при отключении проверок полученных объектов мультимедиа RTCP для активных вызовов в элементах Skype для бизнеса Server 2015 удаляется важный защитный механизм для обнаружения удаленного объекта. Это следует делать только при необходимости.

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

RTCPCallsOnHold

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

Логическое

Этот параметр определяет, продолжают ли пакеты RTCP передаваться по магистрали для вызовов, переведенных в режим удержания, при отсутствии ожидаемого потока мультимедийных пакетов в обоих направлениях. Если на клиенте Skype для бизнеса Server 2015 или на магистрали включено воспроизведение музыки в режиме удержания, вызов считается активным и это свойство игнорируется. В этой ситуации применяется параметр RTCPActiveCalls.

Отключать проверку наличия принятых мультимедийных данных RTCP для активных вызовов в Skype для бизнеса Server 2015 следует только в случае необходимости, так как это устраняет важное средство защиты, позволяющее обнаруживать пропущенный одноранговый узел.

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

SipResponseCodeTranslationRulesList

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

PSListModifier

Список правил преобразования кодов ответов SIP, которые применяются к кодам ответов, полученных от шлюза PSTN, IP-PBX или контроллера SBC у поставщика услуг. Эти правила позволяют администратору сопоставить коды ответа SIP со значениями от 400 до 699, полученные по магистрали, с новыми значениями, которые более подходят для Skype для бизнеса Server 2015.

Вы можете создать этот список и соответствующие правила непосредственно с помощью этого командлета. Однако мы рекомендуем создать правила преобразования кодов ответов SIP, вызвав командлет New-CsSipResponseCodeTranslationRule . Он создает правило и назначает его магистральной конфигурации с соответствующей областью действия.

SRTPMode

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

SRTPMode

Значение этого параметра определяет уровень поддержки SRTP для защиты трафика мультимедиа между посредник и шлюзом PSTN, IP-PBX и контроллером SBC у поставщика услуг. При обходе мультимедиа это значение должно соответствовать параметру EncryptionLevel в конфигурации мультимедиа, которая задается с помощью командлетов New-CsMediaConfiguration и Set-CsMediaConfiguration .

Допустимые значения:

- Required: необходимо использовать шифрование SRTP.

- Optional: шифрование SRTP будет использоваться, если поставщик услуг поддерживает его.

- NotSupported: шифрование SRTP не поддерживается и не может быть использовано.

Примечание. SRTPMode используется, только если шлюз настроен для применения TLS. Если шлюз использует протокол TCP в качестве транспортного протокола, для параметра SRTPMode автоматически задается значение NotSupported.

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

WhatIf

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

SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration. Принимает конвейерный поток объектов магистральной конфигурации.

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

 
Показ: