Set-CsAddressBookNormalizationConfiguration

Skype for Business Server 2015
 

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

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

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

Set-CsAddressBookNormalizationConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsAddressBookNormalizationConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-AddressBookNormalizationRules <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Команда, показанная в примере 1, удаляет правило нормализации адресной книги LongDistanceRule из глобальной коллекции параметров конфигурации для нормализации адресной книги. Для выполнения этой задачи первая команда в примере использует командлет Get-CsAddressBookNormalizationRule для создания ссылки на объект для правила нормализации со значением global/LongDistanceRule для параметра Identity. Результат ссылки на объект сохраняется в переменной с именем $x.

Во второй команде примера используется командлет Set-CsAddressBookNormalizationConfiguraton для удаления правила global/LongDistanceRule из глобальной коллекции. Это выполняется с помощью использования параметра AddressBookNormalizationRules и синтаксиса @{Remove=$x}.

$x = Get-CsAddressBookNormalizationRule -Identity "global/LongDistanceRule"
Set-CsAddressBookNormalizationConfiguration -Identity "global" -AddressBookNormalizationRules @{Remove=$x}

Кроме того, можно удалить правило с помощью командлета Remove-CsAddressBookNormalizationRule.

Remove-CsAddressBookNormalizationRule -Identity "global/LongDistanceRule"

Команда, показанная в примере 2, демонстрирует способ использования командлета Set-CsAddressBookNormalizationConfiguration для копирования правила нормализации адресной книги из одной коллекции в другую. Для этого первая команда в примере использует командлет Get-CsAddressBookNormalizationRule для создания ссылки на объект для правила нормализации со значением global/LongDistanceRule для параметра Identity. Результат ссылки на объект сохраняется в переменной с именем $x.

Во второй команде примера используется командлет Set-CsAddressBookNormalizationConfiguration для добавления этого правила в параметры конфигурации, примененные на сайте Redmond. Это выполняется с помощью подключения к параметрам конфигурации для сайта Redmond и использования параметра AddressBookNormalizationRules и синтаксиса @{Add=$x}. По завершении выполнения этого задания глобальная коллекция и коллекция сайта Redmond будет иметь правило нормализации с именем LongDistanceRule.

$x = Get-CsAddressBookNormalizationRule -Identity "global/LongDistanceRule"
Set-CsAddressBookNormalizationConfiguration -Identity "site:Redmond" -AddressBookNormalizationRules @{Add=$x}

В примере 3 все правила нормализации адресной книги, назначенные сайту Redmond, удаляются. Это выполняется с помощью установки параметру AddressBookNormalizationRules нулевого значения ($Null). Обратите внимание, что коллекция сайта Redmond все еще существует. Однако назначенных правил нормализации у этой коллекции нет.

Set-CsAddressBookNormalizationConfiguration -Identity "site:Redmond" -AddressBookNormalizationRules $Null

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

Использование командлета CsAddressBookNormalizationRule для добавления или удаления этих правил упрощает работу. Эти командлеты позволяют добавлять или удалять правила с помощью одной команды вместо двух. Однако в примере 2 показано, что командлет Set-CsAddressBookNormalizationConfiguration не позволяет копировать правила из одной коллекции в другую.

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

 

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

AddressBookNormalizationRules

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

System.Management.Automation.PSListModifier

Набор правил нормализации, которые применены к этой коллекции параметров конфигурации для нормализации адресной книги.

Хотя этот набор правил можно изменить непосредственно с помощью командлета, рекомендуется создать правила нормализации с помощью командлета New-CsAddressBookNormalizationRule, который создает правила и назначает из указанной коллекции. Впоследствии можно изменить эти правила с помощью командлета Set-CsAddressBookNormalizationRule или удалить правило из коллекции с помощью командлета Remove-CsAddressBookNormalizationRule. Это намного проще и менее подвержено ошибкам, чем изменение коллекции правил с помощью командлета Set-CsAddressBookNormalizationConfiguration и параметра AddressBookNormalizationRules.

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

Подавляет запросы подтверждения до внесения изменений.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор изменяемой коллекции параметров конфигурации для нормализации адресной книги. Чтобы указать глобальные параметры, используйте следующий синтаксис: -Identity "global"

Для указания коллекции, настроенной на уровне сайта, используется следующий синтаксис: -Identity "site:Redmond"

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

Instance

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

System.Management.Automation.PSObject

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

AddressBookNormalizationRules

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

System.Management.Automation.PSListModifier

Набор правил нормализации, которые применены к этой коллекции параметров конфигурации для нормализации адресной книги.

Хотя этот набор правил можно изменить непосредственно с помощью командлета, рекомендуется создать правила нормализации с помощью командлета New-CsAddressBookNormalizationRule, который создает правила и назначает из указанной коллекции. Впоследствии можно изменить эти правила с помощью командлета Set-CsAddressBookNormalizationRule или удалить правило из коллекции с помощью командлета Remove-CsAddressBookNormalizationRule. Это намного проще и менее подвержено ошибкам, чем изменение коллекции правил с помощью командлета Set-CsAddressBookNormalizationConfiguration и параметра AddressBookNormalizationRules.

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

Подавляет запросы подтверждения до внесения изменений.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор изменяемой коллекции параметров конфигурации для нормализации адресной книги. Чтобы указать глобальные параметры, используйте следующий синтаксис: -Identity "global"

Для указания коллекции, настроенной на уровне сайта, используется следующий синтаксис: -Identity "site:Redmond"

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

Instance

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

System.Management.Automation.PSObject

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Командлет Set-CsAddressBookNormalizationConfiguration принимает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationSettings из конвейера.

Отсутствуют. Вместо этого командлет Set-CsAddressBookNormalizationConfiguration изменяет существующие экземпляры объектов Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookNormalizationSettings.

 
Показ: