New-CsStaticRoute

Skype for Business Server 2015
 

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

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

New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TLSRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>] [-TLSCertIssuer <String>] [-TLSCertSerialNumber <Byte[]>] [-UseDefaultCertificate <$true | $false>] <COMMON PARAMETERS>
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TCPRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>] <COMMON PARAMETERS>
COMMON PARAMETERS:

Команды в примере 1 создают новый статический маршрут и добавляют его в глобальную коллекцию конфигураций статической маршрутизации. Для выполнения этой задачи первая команда использует командет New-CsStaticRoute для создания маршрута, который хранится только в памяти и использует TCP в качестве транспортного протокола. Этот маршрут указывает на следующий IP-адрес прыжка 192.168.0.100, использует порт 8025 и выделяет все URI-адреса из домена litwareinc.com. Полученный объект маршрута хранится в переменной $x.

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

$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "litwareinc.com" 

Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}

В примере 2 показано, как можно создать статический маршрут, использующий TLS в качестве транспортного протокола, и добавить его в глобальную коллекцию конфигураций статической маршрутизации. Для этого первая команда использует командлет New-CsStaticRoute для создания маршрута, который хранится только в памяти и использует TLS в качестве транспортного протокола. Маршрут указывает на "atl-proxy-001.litwareinc.com" в качестве точки назначения, использует порт 8025 и выделяет все URI-адреса с суффиксом "litwareinc.com". Кроме того, новый объект маршрута, хранимый в переменной $x, использует сертификат по умолчанию для проверки подлинности (-UseDefaultCertificate $True).

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

$x = New-CsStaticRoute -TLSRoute -Destination "atl-proxy-001.litwareinc.com" -Port 8025 -MatchUri "*.litwareinc.com" -UseDefaultCertificate $True

Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}

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

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

$x = New-CsStaticRoute -TLSRoute -Destination "atl-proxy.litwareinc.com" -Port 5061 -MatchUri "litwareinc.com" -UseDefaultCertificate $False -TLSCertIssuer "CN=CertificateAuthority, DC=litwareinc, DC=com" -TLSCertSerialNumber 0x8f,0x33,0x70,0x93,0x70,0x05,0x33,0x00,0x02,0x33

Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}

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

Новые статические маршруты создаются с помощью командлета New-CsStaticRoute . После создания маршрута командлетом New-CsStaticRoute необходимо добавить маршрут в коллекцию параметров конфигураций маршрутизации, используя командлет Set-CsStaticRoutingConfiguration .

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

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

 

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

Destination

Обязательный

System.String

Если маршрут использует TLS как транспортный протокол, значением параметра Destination является полное доменное имя сервера следующего прыжка. Например: -Destination "atl-proxy-001.litwareinc.com".

Если маршрут использует TCP как транспортный протокол, значением параметра Destination является IP-адрес маршрутизатора следующего прыжка. Например: -Destination "192.168.0.240".

MatchUri

Обязательный

System.String

Полное доменное имя или суффикс домена, используемый для определения того, обрабатывается ли сообщение, отправляемое этому пользователю, данным маршрутом. Например, можно использовать полное доменное имя "litwareinc.com". Этот шаблон соответствует любому пользователю с SIP-адресом, который заканчивается на доменное имя "litwareinc.com".

Для выделения дочерних доменов можно использовать значение с подстановочным символом, например "*.litwareinc.com". Это значение соответствует любому домену, который заканчивается на суффикс "litwareinc.com". Например: northamerica.litwareinc.com, asia.litwareinc.com и europe.litwareinc.com.

Port

Обязательный

System.UInt16

Номер порта, используемый в маршрутизации SIP. Например: -Port 7742.

TCPRoute

Обязательный

System.Management.Automation.SwitchParameter

Настраивает TCP в качестве транспортного протокола для нового маршрута.

TLSRoute

Обязательный

System.Management.Automation.SwitchParameter

Настраивает TLS в качестве транспортного протокола для нового маршрута.

Enabled

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

System.Boolean

Если указано значение True, маршрут включен, а все сообщения, соответствующие шаблону MatchURI, будут направляться на сервер следующего прыжка. Если указано значение False, маршрут отключен и не будет использоваться для маршрутизации сообщений. Значение по умолчанию — True.

MatchOnlyPhoneUri

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

System.Boolean

Если указано значение True, только сообщения, адресованные телефонным URI (например, sip:kenmmyer@litwareinc.com;user=phone), будут выделяться и, возможно, перенаправляться. Если указано значение False (значение по умолчанию), выделяются все сообщения.

ReplaceHostInRequestUri

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

System.Boolean

Если указано значение True ($True), часть Request-URI с узлом будет заменена на адрес сервера следующего прыжка. Если указано значение False, Request-URI используется как есть. Request-URI представляет URI пользователя или службы, которым адресован запрос (сообщение). По умолчанию используется значение False.

TLSCertIssuer

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

System.String

Имя центра сертификации (CA), выдавшего сертификат, который будет использоваться в статическом маршруте. Этот параметр не используется, если вы настроили TCP как транспортный протокол.

Если указан параметр TLSCertIssuer, необходимо также использовать параметр TLSCertSerialNumber.

TLSCertSerialNumber

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

System.Byte[]

Серийный номер сертификата TLS, который будет использоваться в статическом маршруте. Серийные номера необходимо передавать как байтовый массив. Это означает, что нужно передавать серийный номер как массив значений из двух символов. Например: -TLSCertSerialNumber 0x01, 0xA4, 0xD5, 0x67, 0x89.

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

Если указан параметр TLSCertSerialNumber, необходимо также использовать параметр TLSCertIssuer.

UseDefaultCertificate

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

System.Boolean

Настраивает маршрут для использования сертификата Skype для бизнеса Server 2015 по умолчанию в качестве сертификата проверки подлинности. Если вы не хотите использовать сертификат по умолчанию, необходимо указать другой сертификат с помощью параметров TLSCertIssuer и TLSCertSerialNumber.

Для просмотра сертификата по умолчанию используйте следующую команду:

Get-CsCertificate | Where-Object {$_.Use –eq "urn:certref:Default"}

Нет. Командлет New-CsStaticRoute не принимает конвейерные входные данные.

Командлет New-CsStaticRoute создает новые экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Route.

 
Показ: