Test-CsVoiceTestConfiguration

Skype for Business Server 2015
 

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

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

Test-CsVoiceTestConfiguration -TestCaseInputObject <TestConfiguration> [-Dialplan <LocationProfile>] [-RouteSettings <PstnRoutingSettings>] [-VoicePolicy <VoicePolicy>] <COMMON PARAMETERS>
Test-CsVoiceTestConfiguration -DialedNumber <String> -Dialplan <LocationProfile> -VoicePolicy <VoicePolicy> [-RouteSettings <PstnRoutingSettings>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Force <SwitchParameter>]

Этот пример выполняет тест конфигурации голосовой связи TestConfig1. Сначала командлет выполняется Get-CsVoiceTestConfiguration для получения конфигурации, свойство Identity которого имеет значение TestConfig1. Этот объект конфигурации затем передается в командлет Test-CsVoiceTestConfiguration .

Get-CsVoiceTestConfiguration -Identity TestConfig1 | Test-CsVoiceTestConfiguration

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

$a = Get-CsVoiceTestConfiguration -Identity TestConfig1
Test-CsVoiceTestConfiguration -TestCaseInputObject $a

В этом примере запускается тестовая конфигурация без ее определения с помощью командлета New-CsVoiceTestConfiguration . Вместо передачи объекта TestConfiguration, созданного заранее, в этом примере показано, как настроить тест, указав номер для тестирования, а также тарифный план и политику для проверки.

В первой строке примера вызывается командлет Get-CsDialPlan для получения тарифного плана Global. Извлеченный объект тарифного плана назначается переменной $dp. Во второй строке мы делаем то же самое с политикой голосовой связи, вызывая командлет Get-CsVoicePolicy для получения политики Global и назначая эту политику переменной $vp.

Наконец, мы готовы к выполнению теста. Мы вызываем командлет Test-CsVoiceTestConfiguration , передавая номер телефона для тестирования в параметре DialedNumber, тарифный план, полученный в строке 1 (из переменной $dp), в параметре Dialplan и голосовую политику, полученную в строке 2 (из переменной $vp) в параметре VoicePolicy.

Учтите, что выходные данные примера 3 не будут содержать состояние для ожидаемых результатов. Если вы хотите сравнить результаты с ожидаемыми значениями, необходимо определить эти значения, используя командлет New-CsVoiceTestConfiguration и вызывая Test-CsVoiceTestConfiguration , как показано в примерах 1 и 2.

$dp = Get-CsDialPlan -Identity Global
$vp = Get-CsVoicePolicy -Identity Global
Test-CsVoiceTestConfiguration -DialedNumber 4255551212 -Dialplan $dp -VoicePolicy $vp

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

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

Если ввести значения параметров DialedNumber, DialPlan и VoicePolicy, выходные данные будут содержать преобразованный номер, правило нормализации, используемое для создания этого преобразования, используемый маршрут и способ использования PSTN. Если вместо этого ввести значение параметра TestCaseInputObject, можно также получить сведения о том, соответствуют ли результаты ожидаемым значениям, указанным в тестовом объекте, когда он был создан в командлете New-CsVoiceTestConfiguration .

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

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

 

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

DialedNumber

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

System.String

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

Этот параметр является обязательным, если для параметра TestCaseInputObject не задано значение. Нельзя указать параметр DialedNumber и TestCaseInputObject вместе. (TestCaseInputObject уже содержит DialedNumber с этим объектом.)

Dialplan

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

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile

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

Этот параметр является обязательным, если также был указан и параметр DialedNumber. Не используйте данный параметр при применении TestCaseInputObject. В противном случае объект в этом параметре должен совпадать с тарифным планом, указанным в параметре TestCaseInputObject, что делает данный параметр избыточным.

TestCaseInputObject

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

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration

Объект содержит ссылку на голосовую конфигурацию для проверки. Эту ссылку на объект можно извлечь, вызвав командлет Get-CsVoiceTestConfiguration .

При вызове командлета с этим параметром нельзя указать DialedNumber. Также не следует указывать параметр Dialplan или VoicePolicy, так как они будут дублировать значения в объекте тестовой голосовой конфигурации.

VoicePolicy

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

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy

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

Этот параметр является обязательным, если также был указан и параметр DialedNumber. Не используйте данный параметр при применении TestCaseInputObject. В противном случае объект в этом параметре должен совпадать с голосовой политикой, указанной в параметре TestCaseInputObject, что делает данный параметр избыточным.

Force

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

System.Management.Automation.SwitchParameter

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

RouteSettings

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

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings

Ссылка на объект со всеми голосовыми маршрутами, доступными в установке Skype для бизнеса Server 2015. Этот объект можно извлечь, вызвав командлет Get-CsRoutingConfiguration .

Этот параметр можно использовать с параметром DialedNumber или TestCaseInputObject.

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

Этот командлет возвращает объект типа Microsoft.Rtc.Management.Voice.OcsVoiceTestResult.

 
Показ: