Set-CsSipResponseCodeTranslationRule

Skype for Business Server 2015
 

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

Изменяет существующее правило трансляции кода ответа SIP. Эти правила позволяют администраторам сопоставлять SIP-коды ответов со значениями от 400 до 699 и значения, используемые Skype для бизнеса Server 2015. Данный командлет впервые появился в Lync Server 2010.

Set-CsSipResponseCodeTranslationRule [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsSipResponseCodeTranslationRule [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-TranslatedResponseCode <Int32>] [-WhatIf [<SwitchParameter>]]

Команда, показанная в примере 1, изменяет свойство ReceivedISUPCauseValue для правила трансляции с идентификатором Identity PstnGateway:192.168.0.240/Rule404.

Set-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -ReceivedISUPCauseValue 477

В примере 2 правило трансляции с идентификатором Identity PstnGateway:192.168.0.240/Rule404 помечено как правило с максимальным приоритетом, то есть это правило будет обрабатываться первым. Для этого значение свойства Priority устанавливается равным 0.

Set-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -Priority 0

В примере 3 показывается, как можно задать для свойства ReceivedISUPCauseValue всех правил трансляции, настроенных для использования в организации, значение -1. В этом случае при трансляции правил код ошибки ISUP будет игнорироваться. Для этого команда сначала вызывает Get-CsSipResponseCodeTranslationRule без параметров, чтобы получить коллекцию всех правил трансляции SIP-кодов ответов, использующихся в данное время. Затем эта коллекция по конвейеру передается в командлет Set-CsSipResponseCodeTranslationRule , изменяющий свойство ReceivedISUPCauseValue для каждого элемента коллекции.

Get-CsSipResponseCodeTranslationRule | Set-CsSipResponseCodeTranslationRule -ReceivedISUPCauseValue -1

Объединение каналов SIP позволяет подключить VoIP-сеть (такую как система корпоративной голосовой связи) к телефонной сети общего пользования (PSTN). В Skype для бизнеса Server 2015посредник использует магистральные узлы для взаимодействия с PSTN. Если происходит сбой в PSTN при обработке исходящего звонка, автоматически создается код причины ISUP. Например, шлюз PSTN может прислать код причины 34, говорящий о том, что для выполнения вызова нет доступного канала или цепи. Когда магистральный узел посредник получает данный код причины ISUP, он преобразует этот код в код ответа SIP, отправляемый на сам посредник. В свою очередь Skype для бизнеса Server 2015 использует эти коды ответа для принятия решения о маршрутизации исходящих вызовов. Например, неработающему шлюзу может быть назначено состояние "наименее используемого", что снижает вероятность использования данного шлюза до минимума и, соответственно, сильно увеличивает шансы на успешное выполнение вызова.

Однако не все шлюзы применяют рекомендованное сопоставление кодов причины ISUP и кодов ответов SIP, используемое в Skype для бизнеса Server 2015. Для таких шлюзов администраторы могут использовать командлеты CsSipResponseCodeTranslationRule , чтобы сопоставить код ответа SIP шлюза (в сочетании с кодом причины ISUP, если он доступен) с кодом ответа SIP, используемым в Skype для бизнеса Server 2015. Например, шлюз может сопоставлять код причины ISUP 34 ("Линия или канал недоступны") с кодом ответа SIP 486 ("Занято"). В соответствии с кодом ответа 486 логика маршрутизации исходящих вызовов в Skype для бизнеса Server 2015 не будет пытаться найти новый шлюз для завершения вызова.

Однако в Skype для бизнеса Server 2015 код ответа SIP 486 должен сопоставляться с кодом ответа SIP 503. Код ответа 503 запускает механизм повторных попыток в логике маршрутизации исходящих вызовов Skype для бизнеса Server 2015. Это означает, что система будет пытаться найти другой шлюз для выполнения вызова. В этой ситуации можно создать правило преобразования, сопоставляющее сочетание кода причины ISUP 34 и кода ответа SIP 486 с кодом ответа SIP 503.

Командлет Set-CsSipResponseCodeTranslationRule обеспечивает способ изменить все правила трансляции, ранее настроенные для использования в организации.

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

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

 

Параметр Применение Тип Описание

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор изменяемого правила трансляции. Идентификатор Identity для правила трансляции состоит из двух частей: уровень, для которого настроено правило, и имя, назначенное правилу при его создании. Например, для правила трансляции с именем Rule404, созданного на глобальном уровне, должен использоваться идентификатор Identity следующего вида: global/Rule404.

Instance

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

Integer

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

Priority

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

System.Int32

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

ReceivedISUPCauseValue

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

System.Int32

Значение кода ISUP, который должен быть представлен в сообщении ответа SIP, используется шлюзом при ответе на сообщение INVITE (Приглашение). Значение -1 указывает на то, что только код ответа SIP будет использоваться при выполнении правила преобразования; код причины ISUP будет игнорироваться.

ReceivedResponseCode

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

System.Int32

Значение кода ответа SIP используется шлюзом при ответе на сообщение INVITE. Код ответа может быть целым значением в диапазоне от 400 до 699 включительно. Хотя командлет и будет принимать целочисленные значения меньше, чем 400, они не будут распознаваться как окончательные ответы. В результате правила преобразования никогда не будут использоваться. Значение 0 указывает на то, что только код причины ISUP будет использоваться при выполнении правила преобразования; код ответа SIP будет игнорироваться.

TranslatedResponseCode

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

System.Int32

Значение SIP-кода ответа, в который должен быть преобразован код ReceivedResponseCode и/или ReceivedISUPCauseCode. Преобразованные коды ответов могут быть любыми целыми числами в диапазоне 400-699, включительно.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated. Командлет Set-CsSipResponseCodeTranslationRule принимает экземпляры объекта, представляющего правило преобразования кода ответа SIP, из конвейера.

Командлет Set-CsSipResponseCodeTranslationRule не возвращает объекты или значения. Вместо этого, командлет изменяет экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated.

 
Показ: