Test-CsVoiceRoute

Skype for Business Server 2015
 

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

Проверяет номер телефона в соответствии с шаблоном номера для маршрута голосовых вызовов и возвращает логическое значение (true/false), которое указывает, соответствует ли указанный номер шаблону для маршрута. Шаблон номера — это всего лишь одно из свойств маршрута голосовых вызовов, которое позволяет указать Skype для бизнеса Server 2015, как нужно маршрутизировать вызовы пользователей корпоративной голосовой связи на телефонные номера в PSTN или офисной АТС (PBX). Данный командлет впервые появился в Lync Server 2010.

Test-CsVoiceRoute -Route <Route> -TargetNumber <PhoneNumber> [-Force <SwitchParameter>]

Эта команда определяет, соответствует ли указанный номер шаблону для заданного маршрута. Сначала с помощью командлета Get-CsVoiceRoute извлекается маршрут голосовых вызовов testroute. Этот маршрут используется в качестве значения для параметра Route в командлете Test-CsVoiceRoute . В параметре TargetNumber также указывается номер, который нужно проверить. Результатом является логическое значение, которое указывает, соответствует ли целевой номер шаблону для этого маршрута.

$vr = Get-CsVoiceRoute -Identity testroute
Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $vr

В примере 2 выполняется то же действие, что и в примере 1. Однако здесь все выполняется в одной команде. Сначала вызывается командлет Get-CsVoiceRoute , который извлекает маршрут голосовых вызовов со свойством Identity, равным testroute. Затем этот маршрут голосовых вызовов передается в командлет Test-CsVoiceRoute , где для него проверяется номер, указанный в параметре TargetNumber. Обратите внимание, что указывать параметр Route не нужно, поскольку маршрут передается в командлет по конвейеру.

Get-CsVoiceRoute -Identity testroute | Test-CsVoiceRoute -TargetNumber "+14255551212"

В этом примере извлекается коллекция всех маршрутов голосовых вызовов, определенных в развертывании Skype для бизнеса Server 2015, и выполняется проверка номеров каждого маршрута на соответствие шаблону TargetNumber, указанному в вызове Test-CsVoiceRoute . Результатом будет значение True или False для каждого проверенного маршрута.

Get-CsVoiceRoute | Test-CsVoiceRoute -TargetNumber "+14255551212"

Этот пример аналогичен примеру 3, поскольку в нем получаются результаты проверки нескольких маршрутов. Однако выводом примера 3 является просто список значений True/False без ясного указания на то, к какому маршруту относятся результаты. В данном примере эта проблема устраняется. (Есть вещи, которые сделают вывод еще более удобным для восприятия, однако этот короткий пример справляется с поставленной задачей.)

Сначала вызывается командлет Get-CsVoiceRoute , который извлекает все маршруты голосовых вызовов и назначает коллекцию переменной $z. В следующей строке начинается цикл foreach. В этом цикле в каждой итерации элемент коллекции назначается переменной $x. Затем с помощью переменной $x, которая содержит ссылку на один маршрут голосовых вызовов, отображается свойство Identity маршрута: $x.Identity. Затем выполняется вызов командлета Test-CsVoiceRoute , который выполняет проверку маршрута $x в соответствии с целевым номером. Окончательным результатом будет список (с не самым лучшим форматированием) идентификаторов маршрутов голосовых вызовов, за которым с помощью true/false указывается, совпал ли целевой номер с шаблоном номера в маршруте с данным идентификатором.

$z = Get-CsVoiceRoute
foreach ($x in $z){$x.Identity; Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $x}

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

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsVoiceRoute"}

 

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

Route

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

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route

Объект, содержащий ссылку на маршрут голосовых вызовов, с которым нужно сравнить номер, указанный в параметре TargetNumber. Получить объект маршрута голосовых вызовов можно с помощью командлета Get-CsVoiceRoute .

Полный тип данных: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route

TargetNumber

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

Microsoft.Rtc.Management.Voice.PhoneNumber

Телефонный номер, с которым нужно сравнить маршрут голосовых вызовов, указанный в параметре Route. Этот номер должен быть в формате E.164 (например +14255551212).

Полный тип данных: Microsoft.Rtc.Management.Voice.PhoneNumber

Force

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route. Принимает входные данные объекта маршрута голосовых вызовов из конвейера.

Возвращает объект типа Microsoft.Rtc.Management.Voice.VoiceRouteTestResult.

 
Показ: