Test-CsDialPlan

Skype for Business Server 2015
 

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

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

Test-CsDialPlan -DialedNumber <PhoneNumber> -Dialplan <LocationProfile>

В этом примере выполняется тестирование абонентской группы с удостоверением site:Redmond. Сначала выполняется командлет Get-CsDialPlan для извлечения абонентской группы с удостоверением site:Redmond. Затем этот объект абонентской группы передается в командлет Test-CsDialPlan , в котором выполняется тестирование абонентской группы на телефонный номер 14255559999. Результатом будет значение DialedNumber, к которому применяется правило нормализации с соответствующим шаблоном. Если на узле имеется несколько правил нормализации с соответствующим шаблоном, то будет применяться правило с самым низким значением свойства Priority. Если отсутствуют правила с шаблонами, соответствующими значению DialedNumber (например, если правило нормализации соответствует шаблону для 11-значного номера, а предоставляется 7-значный номер), то никакое значение не возвращается.

Результат выполнения этой команды включает номер телефона и правило нормализации. Правило нормализации имеет числовые свойства, и по умолчанию этот результат заканчивается многоточием (...). Чтобы увидеть все свойства и значения извлеченного правила нормализации, мы передаем этот результат в командлет Format-List перед его выводом на экран.В итоге телефонный номер и правило нормализации будут выведены на отдельных строках, а свойства и значения правила нормализации будут переноситься, чтобы поместиться на экране.

Get-CsDialPlan -Identity site:Redmond | Test-CsDialPlan -DialedNumber 14255559999 | Format-List

Пример 2 идентичен примеру 1, за исключением того, что вместо передачи результатов операции Get непосредственно в командлет Test-CsDialPlan объект сначала сохраняется в переменной $a, а затем передается как значение в параметр DialPlan, используемый в качестве абонентской группы, для которой будет выполняться тестирование.

Как и в примере 1, мы выполняем эту команду с помощью направления результатов в командлет Format-List , чтобы просмотреть больше информации о правиле нормализации голосовой связи, чем отображается по умолчанию.

$a = Get-CsDialPlan -Identity site:Redmond
Test-CsDialPlan -DialedNumber 14255559999 -Dialplan $a | Format-List

В этом примере выполняется тестирование всех абонентских групп, заданных в развертывании Skype для бизнеса Server 2015. Сначала выполняется командлет Get-CsDialPlan (без параметров), чтобы извлечь все абонентские группы. Затем полученная коллекция абонентских групп передается в командлет Test-CsDialPlan , где каждая абонентская группа в коллекции тестируется на номер 2065559999. В результате получится список преобразованных номеров с примененным правилом нормализации (по одному правилу нормализации для каждой абонентской группы в коллекции). Если ни одно правило нормализации в абонентской группе не применяется к значению DialedNumber для конкретной абонентской группы (например, если правило нормализации соответствует шаблону для 11-значного номера, а предоставлен 7-значный номер), то в списке для этой абонентской группы будет пустая строка.

По умолчанию в результате обрезается полное отображение примененного правила нормализации. В примерах 1 и 2 мы могли видеть полное отображение, направляя результат теста в командлет Format-List . В данном примере мы направляем результат в командлет Format-Table и включаем параметр Wrap. Мы получим каждую запись в формате таблицы (в одном столбце будет преобразованный номер, а в другом — примененное правило нормализации), но правило нормализации будет переноситься в пределах столбца.

Get-CsDialPlan | Test-CsDialPlan -DialedNumber 2065559999 | Format-Table -Wrap

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

Этот командлет можно использовать для устранения проблем с преобразованием номеров или для проверки применения правил к конкретным номерам.

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

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

 

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

DialedNumber

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

PhoneNumber

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

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

Dialplan

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

LocationProfile

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

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

Объект Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile. Принимает в качестве входных данных объекты абонентской группы, переданные по конвейеру.

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

 
Показ: