New-CsAddressBookNormalizationRule

Skype for Business Server 2015
 

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

Создает новое правило нормализации адресной книги. Правила нормализации адресной книги используются для преобразования телефонных номеров в формат, который понятен Skype для бизнеса Server 2015.

Этот командлет появился в Skype для бизнеса Server 2015.

New-CsAddressBookNormalizationRule -Identity <XdsIdentity> <COMMON PARAMETERS>
New-CsAddressBookNormalizationRule -Name <String> -Parent <String> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Команда в примере 1 создает новое правило нормализации адресной книги с именем RedmondFourDigit. Данное правило будет включено в коллекцию правил нормализации, назначенную сайту Redmond. Новое правило создано для преобразования номеров, которые набираются внутренне только с 4-разрядным расширением. В этом примере свойство Pattern используется для определения 4-разрядного номера, а свойство Translation — для указания значения +1425555 для каждого 4-разрядного номера. Например, если было набрано расширение 1234, то это правило должно преобразовать набранный номер в +14255551234.

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

New-CsAddressBookNormalizationRule -Parent "site:Redmond" -Name RedmondFourDigit -Description "Dialing with internal four-digit extension" -Pattern '^(\d{4})$' -Translation '+1425555$1'

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Обратите внимание, что свойство Identity состоит из параметра Parent (область) и Name. При использовании параметра Identity применение параметров Name или Parent невозможно.

Name

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

System.String

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

Parent

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

System.String

Область действия, в которой будет создано правило нормализации. Правила нормализации адресной книги можно создать на глобальном уровне, на уровне сайта или на уровне службы (только для службы адресной книги). Обратите внимание, что коллекция параметров конфигурации нормализации адресной книги должна быть уже назначена указанной области до добавления правила в эту область. Например, невозможно добавить правило для сайта Redmond, если параметры конфигурации нормализации адресной книги для сайта еще не созданы.

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Description

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

System.String

Позволяет администраторам предоставлять пояснительный текст для сопровождения правила нормализации. Например, описание может объяснить способ преобразования правилом телефонных номеров.

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

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

Pattern

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

System.String

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

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

Priority

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

System.Int32

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

Обратите внимание, что при установке приоритета любые существующие правила пройдут соответствующее изменение нумерации.

Translation

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

System.String

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

Значение по умолчанию — +$. Это является префиксом числа со знаком плюс (+).

WhatIf

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

System.Management.Automation.SwitchParameter

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

Отсутствуют. Командлет New-CsAddressBookNormalizationRule не принимает конвейерные входные данные.

Командлет New-CsAddressBookNormalizationRule создает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationRule#Decorated.

 
Показ: