New-CsVoiceNormalizationRule

Skype for Business Server 2015
 

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

Создает правило нормализации голоса. Правила нормализации голоса используются для преобразования требования набора телефонного номера (например, набор 9 для доступа к внешней линии) в формат E.164, используемый Skype для бизнеса Server 2015. Данный командлет впервые появился в Lync Server 2010.

New-CsVoiceNormalizationRule -Name <String> -Parent <String> <COMMON PARAMETERS>
New-CsVoiceNormalizationRule -Identity <XdsIdentity> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Этот пример создает правило нормализации голоса для сайта Redmond с именем Prefix Redmond. Так как другие параметры не указаны, правило создается со значениями по умолчанию. Обратите внимание, что значение, переданное в параметре Identity, заключено в двойные кавычки. Это связано с тем, что имя правила (Prefix Redmond) содержит пробел. Если имя правила не содержит пробелов, не нужно заключать значение Identity в двойные кавычки.

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

New-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond"

В этом примере создается правило нормализации голоса с именем SeattleFourDigit, которое применяется к тарифному плану пользователя с удостоверением SeattleUser. (Примечание. Вместо указания родительского объекта и имени мы могли создать такое же правило, задав параметры -Identity SeattleUser/SeattleFourDigit.) Мы включили описание этого правила — оно предназначено для преобразования номеров, которые набираются внутренне только с 4-разрядным расширением. Кроме того, указаны значения параметров Pattern и Translation. Они преобразуют 4-разрядный номер (указанный регулярным выражением в параметре Pattern) в такой же номер, но с префиксом значения параметра Translation (+1206555). Например, если введено расширение 1234, это правило преобразует его в номер +12065551234.

Обратите внимание на одинарные кавычки вокруг значений Pattern и Translation. Для этих значений требуются одинарные кавычки, в этом случае нельзя использовать двойные кавычки или указывать значения без кавычек.

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

New-CsVoiceNormalizationRule -Parent SeattleUser -Name SeattleFourDigit -Description "Dialing with internal four-digit extension" -Pattern '^(\d{4})$' -Translation '+1206555$1'

Этот командлет создает именованное правило нормализации голоса. Эти правила являются обязательной частью телефонной авторизации и маршрутизации вызовов. Они определяют требования для преобразования номеров из внутреннего формата Skype для бизнеса Server 2015 в стандартный формат (E.164). Понимание регулярных выражений будет полезно для определения шаблонов номеров, которые будут преобразованы.

Правила, создаваемые этим командлетом, являются частью тарифного плана и, помимо того, что они доступны через командлет Get-CsVoiceNormalizationRule , доступ к ним можно получить с помощью свойства NormalizationRules, которое возвращается при вызове командлета Get-CsDialPlan . Вы не можете создать правило нормализации, если тарифный план с удостоверением Identity, соответствующим уровню, который указан в удостоверении правила, еще не существует. Например, вы не можете создать правило нормализации, с удостоверением site:Redmond/RedmondNormalizationRule, если тарифный план site:Redmond не существует.

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

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

 

Параметр Применение Тип Описание

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор правила. Указанный параметр Identity должен включать уровень, за которым следует косая черта и имя, например site:Redmond/Rule1, где site:Redmond — уровень, а Rule1 — имя, которое автоматически сохраняется в свойстве Name. Вы не можете указать значения для параметров Identity и Name в одной команде.

Правила нормализации голоса можно создать на следующих уровнях: глобальный, уровень сайта, службы (только службы Registrar или PSTNGateway) и конкретного пользователя. Тарифный план с удостоверением, совпадающим с уровнем правила нормализации, должен уже существовать для создания нового правила. (Для получения списка тарифных планов вызовите командлет Get-CsDialPlan .)

Параметр Identity является обязательным, если не задан параметр Parent. В одной команде нельзя одновременно использовать параметры Identity и Parent.

Name

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

System.String

Имя правила. Этот параметр является обязательным, если задано значение для параметра Parent. Если значение не задано, по умолчанию для параметра Name используется имя, указанное в параметре Identity. Например, если создается правило, свойство Identity которого имеет значение site:Redmond/RedmondRule, значение параметра Name по умолчанию будет равно RedmondRule. Нельзя использовать параметры Name и Identity в одной команде.

Parent

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

System.String

Область действия, в которой будет создано правило нормализации. Это значение должно быть глобальным; site:<имя_сайта>, где <имя_сайта> — это имя сайта Skype для бизнеса Server 2015, шлюз PSTN или служба Registrar, например PSTNGateway:redmond.litwareinc.com, или строка, обозначающая правило для конкретного пользователя. Тарифный план должен существовать в указанной области действия, иначе команда завершится с ошибкой.

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Description

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

System.String

Понятное описание правила нормализации.

Максимальная длина строки: 512 символов.

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

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

IsInternalExtension

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

System.Boolean

Если указано значение True, результатом применения этого правила будет внутренний номер организации. Если указано значение False, после применения правила будет получен внешний номер. Это значение игнорируется, если значение свойства OptimizeDeviceDialing связанного тарифного плана равно False.

Значение по умолчанию: False

Pattern

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

System.String

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

Значение по умолчанию: ^(\d{11})$ (Значение по умолчанию представляет любой набор чисел длиной до 11 разрядов.)

Priority

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

System.Int32

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

Translation

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

System.String

Шаблон регулярного выражения, который будет применен к номеру для преобразования его в формат E.164.

Значение по умолчанию: +$1 (При использовании значения по умолчанию к номеру добавляется знак плюса [+].)

WhatIf

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

System.Management.Automation.SwitchParameter

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

Отсутствуют.

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

 
Показ: