Set-CsArchivingConfiguration

Skype for Business Server 2015
 

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

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

Set-CsArchivingConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsArchivingConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-ArchiveDuplicateMessages <$true | $false>] [-BlockOnArchiveFailure <$true | $false>] [-CachePurgingInterval <UInt32>] [-Confirm [<SwitchParameter>]] [-EnableArchiving <None | ImOnly | ImAndWebConf>] [-EnableExchangeArchiving <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-KeepArchivingDataForDays <UInt32>] [-PurgeExportedArchivesOnly <$true | $false>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

В примере 1 командлет Set-CsArchivingConfiguration используется для изменения двух свойств конфигурационных параметров архивации, содержащих параметр Identity site:Redmond. Во-первых команда задает свойству ArchiveDuplicateMessages значение false; это предотвращает архивацию на сервере одного и того же сеанса обмена мгновенными сообщениями несколько раз. Кроме того, команда использует параметр KeepArchivingDataForDays, чтобы сервер сохранял обмен мгновенными сообщениями в течение 30 дней.

Set-CsArchivingConfiguration -Identity site:Redmond -ArchiveDuplicateMessages $False -KeepArchivingDataForDays 30

В примере 2 представлен вариант команды, приведенной в примере 1: в этом случае, однако, значения свойств ArchiveDuplicateMessages и KeepArchivingDataForDays изменяются для всех параметров архивации, настроенных в области веб-сайта. Для выполнения этой задачи команда сначала использует командлет Get-CsArchivingConfiguration c параметром Filter, чтобы вернуть коллекцию всех параметров архивации, настроенных в области веб-сайта; значение параметра filter "site:*" гарантирует, что будут возвращены только те параметры, которые имеют удостоверение, начинающееся с символов "site:". Затем отфильтрованная коллекция поступает в командлет Set-CsArchivingConfiguration , который изменяет значения двух свойств каждого элемента коллекции.

Get-CsArchivingConfiguration -Filter "site:*" | Set-CsArchivingConfiguration -ArchiveDuplicateMessages $False -KeepArchivingDataForDays 30

В примере 3 изменяются все конфигурационные параметры архивации, которые разрешают как сеанс IM, так и архивацию веб-конференций; после выполнения этой команды данные параметры позволят выполнить архивацию только сеанса IM. Для этого команда сначала использует командлет Get-CsArchivingConfiguration без параметров, чтобы вернуть коллекцию всех конфигурационных параметров архивации, используемых в настоящий момент в организации. Эта коллекции затем поступает в командлет Where-Object , который распознает только те параметры, в которых свойство EnableArchiving равно "ImAndWebConf". Затем, отфильтрованная коллекция поступает в командлет Set-CsArchivingConfiguration , который изменяет значение свойства EnableArchiving на "ImOnly" каждого элемента коллекции.

Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -eq "ImAndWebConf"} | Set-CsArchivingConfiguration -EnableArchiving "ImOnly"

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

Чтобы провести архивацию мгновенных сообщений, необходимо настроить по крайней мере один сервер архивации. После настройки сервера архивации необходимо выполнить два дополнительных этапа. Во-первых, включить архивацию в глобальной области видимости (дополнительные сведения см. в разделе командлета Set-CsArchivingConfiguration ). При необходимости можно настроить особые параметры архивации для различных веб-сайтов.

Во-вторых, использовать политики архивации, чтобы определить пользователей, которые будут иметь свои архивированные сеансы IM. Сеансы IM не будут архивироваться, если политика, требующая архивации сеансов IM, не действует.

После установки Skype для бизнеса Server 2015, будет создана коллекция глобальных конфигурационных параметров архивации; по умолчанию эти параметры будут применяться для организации в целом. В качестве альтернативы можно использовать командлет New-CsArchivingConfiguration , чтобы создать пользовательские конфигурационные параметры на основе метода "сайт-сайт". В любом случае можно использовать командлет Set-CsArchivingConfiguration для изменения значений свойств существующей коллекции или конфигурационных параметров архивации.

 

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

ArchiveDuplicateMessages

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

System.Boolean

Указывает, способ архивации мгновенных сообщений "кросс-пул". Рассмотрим простой пример. Ken Myer (с учетной записью в пуле 1) отправляет мгновенное сообщение Pilar Ackerman, которая имеет учетную запись в пуле 2. Pilar, в свою очередь, отправляет ответ на его сообщение. Если параметр ArchiveDuplicateMessages установлен в значение False, то (в зависимости от встроенного алгоритма) запись сеанса будет регистрироваться либо в пуле 1, либо в пуле 2, но не одновременно. Если параметр ArchiveDuplicateMessages установлен в значение True (значение по умолчанию), запись будет регистрироваться в обеих пулах.

BlockOnArchiveFailure

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

System.Boolean

Если данный параметр установлен в значение True, служба обмена мгновенными сообщениями будет приостановлена, поэтому архивация этих сообщений невозможно. Если параметр установлен в значение False (значение по умолчанию), обмен мгновенными сообщениями будет продолжен даже в том случае, если невозможно выполнить архивацию сообщений.

CachePurgingInterval

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

System.UInt32

Показывает периодичность (в часах) очистки системы от записей, где отсутствуют участники, для которых включена архивация. По дизайну все сеансы IM для групп и сеансы конференций записываются, если они существуют. Периодически система определяет, включена ли архивация для какого-либо из участников. Если система находит сеанс, где нет участников, для которых включена архивация, запись разговора будет удалена из базы данных.

Значением свойства CachePurgingInterval может быть любое целое число в диапазоне от 4 до 168 включительно. Значение по умолчанию — 24.

Confirm

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

System.Management.Automation.SwitchParameter

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

EnableArchiving

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

Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.EnableArchiving

Показывает, какие элементы (если имеются) сохраняются для архивации базы данных. Допускаются следующие значения:

Нет. Отсутствуют элементы для архивации в базе данных. Это значение по умолчанию.

ImOnly. Сеансы обмена мгновенными сообщениями (IM) архивируются в базе данных.

ImAndWebConf. Сеансы обмена мгновенными сообщениями и сеансы веб-конференций архивируются в базе данных.

EnableExchangeArchiving

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

System.Boolean

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

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

EnablePurging

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

System.Boolean

Если параметр установлен в True, архивированные мгновенные сообщения будут периодически удаляться из базы данных, при условии, что они: 1) старше значения, указанного в свойстве KeepArchivingDataForDays; или 2) экспортированы и помечены для удаления.

Если установлен в значение False, мгновенные сообщения не удаляются автоматически из базы данных.

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Чтобы изменить параметры, назначенные отдельному пулу регистраторов, используйте следующий синтаксис:

-Identity "service:Registrar:atl-cs-001.litwareinc.com"

Instance

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

объект ArchivingSettings

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

KeepArchivingDataForDays

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

System.UInt32

Количество дней (от 1 до 2562), в течение которого архивированные мгновенные сообщения хранятся в базе данных, прежде чем они будут автоматически удалены. Значение по умолчанию — 14.

Это свойство действует только в том случае, если параметр EnablePurging установлен в значение True.

PurgeExportedArchivesOnly

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

System.Boolean

Если параметр установлен в значение True, система удалит только те мгновенные сообщения, которые были экспортированы (и, в результате, были помечены для удаления). Мгновенные сообщения, которые не были экспортированы останутся в базе данных, даже если они старше, чем значение, указанное в свойстве KeepArchivingDataForDays.

PurgeHourOfDay

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

System.UInt32

Указывает местное время суток для удаления записей с истекшим сроком действия из базы данных CDR. Время суток задается в 24-часовом формате (0 соответствует полуночи (00:00), а 23 — 23:00 часам вечера). Обратите внимание, что можно указать только час, т. е. удаление можно запланировать на 4:00 утра, но не на 4:30 или 4:15. Значение по умолчанию — 2 часа утра (02:00).

Очистка базы данных выполняется только в том случае, если свойство EnablePurging установлено в значение True.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings. Командлет Set-CsArchivingConfiguration принимает конвейерный ввод объектов конфигурации архивации.

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

 
Показ: