Set-CsStaticRoutingConfiguration

Skype for Business Server 2015
 

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

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

Set-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsStaticRoutingConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Команды в примере 1 копируют маршрут из коллекции глобальной статической маршрутизации и привязывают его ко второй коллекции с удостоверением service:Registrar:atl-cs-001.litwareinc.com. Для этого первая команда в примере подключается к глобальной коллекции и возвращает объектную ссылку на маршрут, где в свойствах MatchUri litwareinc.com и MatchOnlyPhoneUri выбрано значение True.

Для этого команда вызывает командлет Get-CsStaticRoutingConfiguration , который возвращает сведения из коллекции конфигураций глобальной статической маршрутизации. Затем эти данные передаются в командлет Select-Object , который с помощью параметра ExpandProperty развертывает значения свойства Route. Развернутые значения (представляющие собой отдельные маршруты коллекции) передаются в командлет Where-Object , выбирающий маршрут, свойство MatchUri которого равно litwareinc.com, а для свойства MatchOnlyPhoneUri установлено значение True. Возвращаемый маршрут сохраняется в переменной $x.

После получения маршрута вторая команда в примере добавляет его в коллекцию service: Registrar:atl-cs-001.litwareinc.com. Для этого вызывается командлет Set-CsStaticRoutingConfiguration с параметром Route. Значение параметра @{Add=$x} предписывает командлету Set-CsStaticRoutingConfiguration добавить маршрут, хранящийся в переменной $x, в коллекцию маршрутов свойства Route.

$x = Get-CsStaticRoutingConfiguration -Identity global | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Add=$x}

Команды в примере 2 удаляют маршрут из коллекции статической маршрутизации. Для этого первая команда в примере подключается к коллекции с идентификатором service:Registrar:atl-cs-001.litwareinc.com и возвращает объектную ссылку на маршрут со свойством MatchUri, равным litwareinc.com, и свойством MatchOnlyPhoneUri, равным True. Для этого команда вызывает командлет Get-CsStaticRoutingConfiguration , чтобы получить информацию из коллекции service:Registrar:atl-cs-001.litwareinc.com. Затем эти данные передаются в командлет Select-Object , который с помощью параметра ExpandProperty развертывает значения свойства Route. Развернутые значения (представляющие собой отдельные маршруты коллекции) передаются в командлет Where-Object , выбирающий один маршрут со свойством MatchUri, равным litwareinc.com, и свойством MatchOnlyPhoneUri со значением True. Возвращенный маршрут сохраняется в переменной $x.

После получения маршрута вторая команда удаляет маршрут из коллекции. Для этого вызывается командлет Set-CsStaticRoutingConfiguration с параметром Route. Значение параметра @{Remove=$x} предписывает командлету Set-CsStaticRoutingConfiguration удалить маршрут, хранящийся в переменной $x.

$x = Get-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Remove=$x}

В примере 3 удаляются все маршруты коллекции конфигурации статической маршрутизации. Для этого требуется включить параметр Route и установить для него нулевое значение. После выполнения команды коллекция все еще существует, но в ней нет ни одного маршрута.

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route $Null

При отправке кому-либо SIP-сообщения это сообщение, возможно, должно будет пройти через несколько сетей и подсетей, прежде чем будет доставлено; путь, который проходит сообщение, часто называется маршрутом. В сетях существует два типа маршрутов: динамические и статические. При динамической маршрутизации серверы с помощью алгоритмов определяют следующее расположение (следующий прыжок), куда следует направить сообщение. При статической маршрутизации пути сообщений предварительно определяются системными администраторами. Когда сервер получает сообщение, он проверяет его адрес, а затем направляет сообщение на сервер следующего прыжка, предварительно настроенный администратором. При правильной настройке статические маршруты помогают обеспечить своевременную и точную доставку сообщений с минимальными временными потерями на серверах. Недостаток статических маршрутов заключается в том, что в случае ошибки в сети динамическое перенаправление сообщений не выполняется.

При установке Skype для бизнеса Server 2015 автоматически создается глобальная коллекция статических маршрутов (создается пустой список).К тому же, программа позволяет создавать дополнительные коллекции, применяемые на уровне службы (они могут прикрепляться только к службе регистратора). Командлет Set-CsStaticRoutingConfiguration позволяет изменять значения свойств существующей коллекции статической маршрутизации. Таким образом, этот командлет можно использовать для добавления новых маршрутов в коллекцию или удалять из нее существующие.

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

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

 

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор изменяемой коллекции конфигураций статической маршрутизации. Для изменения глобальной коллекции используется следующий синтаксис: -Identity global. Для изменения коллекции на уровне службы, используется следующий синтаксис: -Identity "service:Registrar:atl-cs-001.litwareinc.com". При вводе идентификатора нельзя использовать подстановочные знаки.

Если этот параметр не указан, командлет Set-CsStaticRoutingConfiguration автоматически изменяет глобальную коллекцию.

Instance

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

объект RoutingSettings

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

Route

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

System.Management.Automation.PSListModifier

Отдельные статические маршруты коллекции. Маршруты, добавляющиеся в коллекцию, должны копироваться из другой коллекции или создаваться с помощью командлета New-CsStaticRoute . Для удаления командлета из коллекции сначала нужно создать объектную ссылку на маршрут. Дополнительные сведения см. в справочном разделе "Примеры".

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings. Командлет Set-CsStaticRoutingConfiguration принимает из конвейера экземпляры объекта параметров статической маршрутизации.

Командлет Set-CsStaticRoutingConfiguration не возвращает значение или объект. Вместо этого он настраивает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

 
Показ: