Test-CsVoicePolicy

Skype for Business Server 2015
 

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

Проверяет номер телефона применительно голосовой политики и проверяет голосовой маршрут, который будет использоваться применительно к этой политике для данного номера. Данный командлет впервые появился в Lync Server 2010.

Test-CsVoicePolicy -TargetNumber <PhoneNumber> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]

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

Get-CsVoicePolicy -Identity site:Redmond | Test-CsVoicePolicy -TargetNumber "+14255559999"

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

$a = Get-CsVoicePolicy -Identity site:Redmond
Test-CsVoicePolicy -TargetNumber "+14255559999" -VoicePolicy $a

В этом примере тестирование голосовой политика выполняется применительно ко всем голосовым политикам, определенным при развертывании Skype для бизнеса Server 2015. Сначала запускается командлет Get-CsVoicePolicy (без параметров) для получения всех голосовых политик. Возвращаемая им коллекция политик передается командлету Test-CsVoicePolicy , где каждая политика в коллекции проверяется на соответствие маршрута, основанного на представленном целевом номере телефона (+12065559999) и использовании телефона. Выходные данные будут представлять собой соответствующие маршруты, а также соответствующие сведения об использовании телефона.

Get-CsVoicePolicy | Test-CsVoicePolicy -TargetNumber "+12065559999"

Голосовые политики связаны с голосовыми маршрутами через использование телефонной сети общего пользования (PSTN). Звонок от пользователя, назначенного конкретной голосовой политике, может быть направлен по маршруту, в котором использование PSTN соответствует использованию, определенному в данной политике, а также шаблон номера соответствует набранному номеру. Вызовите командлет Test-CsVoicePolicy , чтобы определить, какой маршрут (если имеется) будет использован для маршрутизации звонка от пользователя с данной конкретной голосовой политикой, а также использование какого телефона связывает данную политику с данным маршрутом.

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

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

 

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

TargetNumber

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

PhoneNumber

Номер телефона применительно к которому выполнялось тестирование. Этот номер должен быть в формате E.164 (например +14255551212).

VoicePolicy

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

VoicePolicy

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

Force

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

SwitchParameter

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

RouteSettings

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

PstnRoutingSettings

Параметры маршрута, относительно которого запускается тест. Данные параметры маршрута могут быть получены с помощью вызова командлета Get-CsRoutingConfiguration .

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

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

 
Показ: