Set-CsAddressBookConfiguration

Skype for Business Server 2015
 

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

Изменяет существующую коллекцию параметров конфигурации адресной книги. Данный командлет впервые появился в Lync Server 2010.

Set-CsAddressBookConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsAddressBookConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-EnablePhotoSearch <$true | $false>] [-EnableSearchByDialPad <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-MaxFileShareThreadCount <Int32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]

В этом примере свойству RunTimeOfDay (это свойство определяет время суток, когда производится синхронизация адресной книги) присваивается значение 23:00. Параметр Identity используется для ограничения параметров конфигурации адресной книги теми, которые имеют значение site:Redmond.

Set-CsAddressBookConfiguration -identity site:Redmond -RunTimeOfDay 23:00

В примере 2 свойство RunTimeOfDay получает значение 23:00 для всех коллекций параметров адресной книги, настроенных на уровне сайта. Для этого команда сначала использует командлет Get-CsAddressBookConfiguration и параметр Filter, чтобы вернуть коллекцию параметров уровня сайта; значение фильтра "site:*" ограничивает возвращаемые данные коллекциями, настроенными на уровне сайта. Эти сведения затем передаются в командлет Set-CsAddressBookConfiguration , который изменяет значение свойства RunTimeOfDay для каждого элемента в коллекции.

Get-CsAddressBookConfiguration -Filter site:* | Set-CsAddressBookConfiguration -RunTimeOfDay 23:00

В примере 3 изменяется свойство KeepDuration для всех коллекций параметров адресной книги, где свойство KeepDuration меньше 30 дней. Для этого используется командлет Get-CsAddressBookConfiguration без дополнительных параметров, который возвращает коллекцию всех параметров адресной книги, настроенных для использования в организации. Коллекция затем передается в командлет Where-Object , который выбирает только те параметры, у которых свойство KeepDuration меньше 30 дней. Отфильтрованная коллекция передается в командлет Set-CsAddressBookConfiguration , который изменяет значение свойства KeepDuration для каждого элемента в коллекции на 30 дней.

Get-CsAddressBookConfiguration | Where-Object {$_.KeepDuration -lt 30} | Set-CsAddressBookConfiguration -KeepDuration 30

Серверы адресных книг являются посредниками между доменными службами Active Directory (AD DS) и Skype для бизнеса Server 2015. Сервер адресной книги обеспечивает синхронизацию пользовательских данных, хранимых в Skype для бизнеса Server 2015, с данными в доменных службах. Для этого файлы адресной книги периодически синхронизируются с данными, хранимыми в базе данных пользователей.

Кроме того, серверы адресных книг периодически создают файлы индекса, загружаемые на компьютеры, на которых выполняется Skype для бизнеса Server 2015. Если пользователь ищет контакты, то поиск выполняется либо в этих файлах, либо в файлах индекса адресной книги, хранимых в центральном хранилище управления.

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

Командлет Set-CsAddressBookConfiguration позволяет изменить любую коллекцию параметров конфигурации адресной книги, используемую в организации в текущий момент.

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

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

 

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

Confirm

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

System.Management.Automation.SwitchParameter

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

EnableFileGeneration

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

System.Boolean

Если задано значение True (значение по умолчанию) сервер адресных книг создает файлы индекса адресных книг, которые могут быть загружены клиентами. Когда параметр имеет значение False, файлы индексов не создаются. Это значит, что клиентские приложения должны будут использовать службу Служба веб-запросов к адресной книге для поиска контактов.

EnablePhotoSearch

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

System.Boolean

Если установлено значение True, пользовательские фотографии будут отображаться в результатах поиска.

EnableSearchByDialPad

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

System.Boolean

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

По умолчанию установлено значение True ($True).

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Если этот параметр не указан, командлет Set-CsAddressBookConfiguration изменит глобальные параметры.

IgnoreGenericRules

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

System.Boolean

Указывает, игнорирует ли сервер адресных книг общие правила нормализации, используемые для анализа телефонных номеров. Общие правила — это те правила, которые встроены в Skype для бизнеса Server 2015. Эти правила нельзя изменить; однако, задав значение описываемого здесь свойства как True, можно запрограммировать серверы адресных книг игнорировать общие правила и вместо них использовать настраиваемые правила, созданные самостоятельно. Значение по умолчанию — False.

Instance

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

Объект AddressBookSettings

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

KeepDuration

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

System.UInt32

Указывает время (в днях) которое сервер адресных книг будет хранить файлы изменений. Файлы изменений старше значения свойства KeepDuration удаляются. Свойству KeepDuration можно присвоить любое целое значение между 1 и 90 включительно. Значение по умолчанию — 30 дней.

MaxDeltaFileSizePercentage

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

System.UInt32

Когда в Active Directory вносятся изменения (например, новый пользователь получает права на использование Skype для бизнеса Server 2015), сервер адресных книг обычно записывает эти изменения в «дельта-файл» — файл, состоящий только из измененных данных; Skype для бизнеса Server 2015 может затем загрузить дельта-файлы вместо того, чтобы загружать полный файл адресной книги. Свойство MaxDeltaFileSizePercentage определяет, насколько большим может стать дельта-файл перед тем, как он будет включен в полный файл адресной книги. По умолчанию дельта-файлы могут иметь размер 20 процентов от полного файла адресной книги перед тем, как создается новый файл адресной книги. В этот случае клиенты загружают полный файл вместо дельта-файла.

Свойство MaxDeltaFileSizePercentage должно быть введено как процент между 1 и 100 включительно.

MaxFileShareThreadCount

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

System.Int32

Указывает максимальное количество системных ресурсов, которые могут использоваться сервером адресной книги при проблемах доступа к общему файловому ресурсу в сервисе. Значение по умолчанию — 300.

RunTimeOfDay

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

System.DateTime

Указывает время суток, когда серверы создают новые файлы адресной книги. Свойство RunTimeOfDay основывается на 24-часовом формате (часы:минуты:секунды).

Значение по умолчанию — 01:30:00.

SynchronizePollingInterval

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

System.TimeSpan

Указывает, насколько часто серверы адресных книг синхронизируют свои данные с данными, хранящимися в базе данных пользователей. Параметр SynchronizePollingInterval можно настроить в диапазоне 5 секунд (00:00:05) и 3 часа (03:00:00). Значение по умолчанию — 5 минут (00:05:00).

UseNormalizationRules

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

System.Boolean

Указывает, должны ли серверы адресных книг использовать правила нормализации телефонов, запрашивая номера телефонов. Если задано значение False, телефонные номера будут запрашиваться как есть, правила нормализации должно будет применять клиентское приложение, отображая эти номера.

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings. Командлет Set-CsAddressBookConfiguration принимает в качестве входных данных из конвейера объекты конфигурации адресной книги.

Командлет Set-CsAddressBookConfiguration не возвращает значение или объект. Он настраивает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

 
Показ: