New-CsVoiceTestConfiguration

Skype for Business Server 2015
 

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

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

New-CsVoiceTestConfiguration -Name <String> <COMMON PARAMETERS>
New-CsVoiceTestConfiguration -Identity <XdsGlobalRelativeIdentity> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]

В этом примере создается новая тестовая конфигурация голосовой связи со значениями по умолчанию, которая имеет удостоверение TestConfig1.

New-CsVoiceTestConfiguration -Identity TestConfig1

В этом примере создается новая тестовая конфигурация голосовой связи с именем TestConfig1 и для параметра TargetDialplan устанавливается значение site:Redmond1. В результате тестирование предполагаемого номера, режима работы и маршрута будет выполняться с параметрами абонентской группы для узла Redmond1.

В этом примере мы объявили TestConfig1 без указания параметра Identity. Identity является позиционным параметром, поэтому первое значение, следующее за именем командлета, будет восприниматься командлетом как значение Identity.

New-CsVoiceTestConfiguration TestConfig1 -TargetDialplan site:Redmond1

В этом примере создается новая тестовая конфигурация голосовой связи с именем TestConfig1. Эта конфигурация будет использовать значения по умолчанию для тестирования номера DialedNumber 5551212 с предполагаемым результатом (ExpectedTranslatedNumber) +5551212. Это предположение строится на основе правил нормализации, связанных с абонентской группой, которая будет использоваться при тестировании. Это тестирование должно выполняться с помощью командлета Test-CsVoiceTestConfiguration .

New-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212

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

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

Конфигурации, созданные с помощью этого командлета, тестируются с помощью командлета Test-CsVoiceTestConfiguration .

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity

Строка, однозначно идентифицирующая данный тестовый сценарий.

Эта строка может быть длиной до 32 символов, и может содержать любые буквы и цифры плюс символы обратной косой черты (\), точки (.) и подчеркивания (_).

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

Name

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

System.String

Этот параметр содержит то же значение, что и параметр Identity. Если параметр Identity указан, то в команду нельзя включать параметр Name. И наоборот, если указан параметр Name, то нельзя включать параметр Identity.

Confirm

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

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

DialedNumber

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

System.String

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

Должно быть не более 512 символов.

По умолчанию: 1234

ExpectedRoute

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

System.String

Имя маршрута голосовых вызовов, использование которого ожидается во время тестирования конфигурации. Если будет использоваться другой маршрут, выбранный на основе целевой абонентской группы и политики голосовой связи, тестирование завершится неудачно. Чтобы получить доступные маршруты голосовых вызовов, можно вызвать командлет Get-CsVoiceRoute .

Должно быть не более 256 символов.

ExpectedTranslatedNumber

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

System.String

Номер телефона в формате, который предполагается увидеть после преобразования. Это значение параметра DialedNumber после нормализации. Если запуск командлета Test-CsVoiceTestConfiguration с параметром DialedNumber не приводит к значению, указанному в параметре ExpectedTranslatedNumber, то тестирование будет считаться неудачным.

Должно быть не более 512 символов.

По умолчанию: +1234

ExpectedUsage

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

System.String

Имя режима работы с ТСОП, использование которого ожидается во время тестирования конфигурации. Если будет использоваться другой режим, выбранный на основе целевой абонентской группы и политики голосовой связи, тестирование завершится неудачно. Чтобы получить доступные режимы работы с ТСОП, можно вызвать командлет Get-CsPstnUsage .

Должно быть не более 256 символов.

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

Создает ссылку на объект без фиксации объекта в качестве постоянного изменения. Если выходные данные этого командлета, вызванного с помощью указанного параметра, назначаются переменной, можно внести изменения в свойства ссылки на объект и затем зафиксировать эти изменения, вызвав соответствующий командлет Set-<cmdlet> .

TargetDialplan

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

System.String

Удостоверение абонентской группы, которая будет использоваться для данного тестирования. Абонентские группы можно извлечь с помощью командлета Get-CsDialPlan .

Должно быть не более 40 символов.

Значение по умолчанию — Global

TargetVoicePolicy

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

System.String

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

Должно быть не более 40 символов.

Значение по умолчанию — Global

WhatIf

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

System.Management.Automation.SwitchParameter

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

Этот командлет создает объект типа Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration.

 
Показ: