Set-CsVoiceNormalizationRule

Skype for Business Server 2015
 

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

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

Set-CsVoiceNormalizationRule [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsVoiceNormalizationRule [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

В этом примере показано, как задать для описания правила Prefix Redmond сайта Redmond значение "Добавлять префикс ко всем номерам на сайте Redmond".

Set-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond" -Description "Add a prefix to all numbers on site Redmond"

В этом примере показано, как изменить правило нормализации голосовых служб со значением свойства Identity global/SeattleFourDigit. С учетом изменений правила добавлено новое правило Description. Кроме того, задано правило Translation, изменяющее правило перевода всех номеров, соответствующих существующему шаблону данного правила, в такой же номер с префиксом +1206556. Например, если существующий шаблон соответствует какому-либо четырехзначному номеру, и введен номер 1234, это правило переведет добавочный номер в формат +12065561234.

Set-CsVoiceNormalizationRule -Identity global/SeattleFourDigit -Description "Translate an internal four-digit extension" -Translation '+1206556$1'

В примере 3 показано, как изменить правило нормализации. Необходимо учесть, что при изменении имени также изменяется составляющая имени в свойстве Identity. Командлет Set-CsVoiceNormalizationRule не имеет параметра Name, поэтому для изменения имени сначала вызывается командлет Get-CsVoiceNormalizationRule , что позволяет извлечь правило со значением свойства Identity global/RedmondFourDigit и присвоить возвращенный объект переменной $a. Затем строка "RedmondRule" присваивается свойству Name этого объекта. После этого переменная передается в параметр Instance командлета Set-CsVoiceNormalizationRule для сохранения изменения.

$a = Get-CsVoiceNormalizationRule -Identity global/RedmondFourDigit
$a.name = "RedmondRule"
Set-CsVoiceNormalizationRule -Instance $a

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

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

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

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

 

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Description

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

System.String

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

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

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Instance

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

NormalizationRule

Позволяет передать в командлет ссылку на объект вместо задания значений отдельных параметров. Этот объект должен иметь тип NormalizationRule, и его можно извлечь путем вызова командлета Get-CsVoiceNormalizationRule .

IsInternalExtension

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

System.Boolean

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

Pattern

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

System.String

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

Priority

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

System.Int32

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

Translation

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

System.String

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule. Командлет Set-CsVoiceNormalizationRule принимает в качестве входных данных объекты правил нормализации голосовых вызовов.

Командлет Set-CsVoiceNormalizationRule не возвращает значение или объект. Вместо этого он настраивает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.

 
Показ: