New-CsAddressBookConfiguration

Skype for Business Server 2015
 

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

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

New-CsAddressBookConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-EnablePhotoSearch <$true | $false>] [-EnableSearchByDialPad <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-InMemory <SwitchParameter>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-MaxFileShareThreadCount <Int32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]

В примере 1 создается новая коллекция параметров конфигурации адресной книги с параметром identity site:Redmond. Для создания новой коллекции необходимо вызвать командлет New-CsAddressBookConfiguration с параметром Identity и любыми другими необязательными параметрами (например, KeepDuration и SynchronizePollingInterval).

New-CsAddressBookConfiguration -Identity site:Redmond -KeepDuration 15 -SynchronizePollingInterval 00:10:00

В примере 2 создается новая коллекция параметров конфигурации адресной книги для сайта Paris; в этой новой коллекции используются два значения (KeepDuration и SynchronizePollingInterval), скопированные из параметров конфигурации адресной книги для набора Redmond. Для выполнения этой задачи первая команда вызывает командлет Get-CsAddressBookConfiguration , который возвращает коллекцию всех параметров конфигурации адресной книги, заданных для сайта Redmond; эта информация сохраняется в переменной с именем $x.

Вторая команда использует командлет New-CsAddressBookConfiguration для создания параметров конфигурации адресной книги для сайта Pairs. Эта команда содержит два необязательных параметра (KeepDuration и SynchronizePollingInterval), значения которых скопированы из site:Redmond. Например, KeepDuration использует значение параметра $x.KeepDuration; это значение параметра представляет собой информацию KeepDuration, скопированную с сайта Redmond.

$x = Get-CsAddressBookConfiguration -Identity site:Redmond
New-CsAddressBookConfiguration -Identity site:Paris -KeepDuration $x.KeepDuration -SynchronizePollingInterval $x.SynchronizePollingInterval

В примере 3 показано, как с помощью параметра InMemory создать размещаемый только в памяти экземпляр коллекции параметров конфигурации адресной книги, изменить эти параметры в памяти и затем с помощью командлета Set-CsAddressBookConfiguration создать фактическую коллекцию с параметром Identity site:Redmond. Для выполнения всех этих действий первая команда создает новый размещаемый в памяти экземпляр коллекции параметров конфигурации адресной книги и сохраняет этот экземпляр в переменной с именем $x. Установка параметра InMemory обеспечивает существование параметров конфигурации адресной книги только в памяти; если завершить сеанс Skype для бизнеса Server 2015 или удалить переменную $x, параметры конфигурации будут потеряны и не будут применены к сайту Redmond.

Команды 2 и 3 изменяют два свойства этих виртуальных параметров конфигурации адресной книги: команда 2 устанавливает для свойства KeepDuration значение 15 дней, а команда 3 устанавливает для свойства SynchronizePollingInterval значение 10 минут (00:10:00). Четвертая и последняя команда использует командлет Set-CsAddressBookConfiguration и параметр Instance для преобразования виртуальных параметров конфигурации адресной книги в фактическую коллекцию параметров, заданных для сайта Redmond.

$x = New-CsAddressBookConfiguration -Identity site:Redmond -InMemory
$x.KeepDuration = 15
$x.SynchronizePollingInterval = "00:10:00"
Set-CsAddressBookConfiguration -Instance $x

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

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

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

Параметры уровня сайта создаются с помощью командлета New-CsAddressBookConfiguration . Можно создавать параметры только в области сайта; если попытаться создать новые параметры в любой другой области, включая глобальную, при выполнении команды возникнет ошибка. Ошибка возникнет и в том случае, если соответствующий сайт уже содержит коллекцию параметров конфигурации адресной книги.

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Новой коллекции параметров конфигурации адресной книги должен быть назначен уникальный идентификатор. Поскольку новые коллекции можно создавать только в области сайта, параметр Identity всегда будет представлять собой префикс "site:", за которым следует имя сайта; например, "site:Redmond".

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

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

IgnoreGenericRules

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

System.Boolean

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

InMemory

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

System.Management.Automation.SwitchParameter

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

KeepDuration

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

System.UInt32

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

MaxDeltaFileSizePercentage

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

System.UInt32

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

Значение 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

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

Нет. Командлет New-CsAddressBookConfiguration не принимает входные данные из конвейера.

Создаются экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

 
Показ: