Set-CsPersistentChatConfiguration

Skype for Business Server 2015
 

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

Изменяет существующую коллекцию параметров конфигурации сохраняемого чата. Эти параметры используются для управления службой Persistent Chat. Например, они позволяют указать максимальное число пользователей, допускаемых к участию в комнате чата. Данный командлет впервые появился в Lync Server 2013.

Set-CsPersistentChatConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsPersistentChatConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-DefaultChatHistory <Int16>] [-Force <SwitchParameter>] [-MaxFileSizeKB <UInt32>] [-ParticipantUpdateLimit <UInt32>] [-RoomManagementUrl <String>] [-WhatIf [<SwitchParameter>]]

Команда, представленная в примере 1, присваивает свойству DefaultChatHistory глобальных параметров конфигурации сохраняемых сеансов бесед значение 100.

Set-CsPersistentChatConfiguration -Identity "global" -DefaultChatHistory 100

В примере 2 свойству DefaultChatHistory всех параметров конфигурации сохраняемого чата присваивается значение 100. Для этого сначала используется командлет Get-CsPersistentChatConfiguration , возвращающий коллекцию всех параметров конфигурации сохраняемого чата в организации. Эта коллекция передается в командлет Set-CsPersistentChatConfiguration , который изменяет значение свойства DefaultChatHistory для всех ее элементов.

Get-CsPersistentChatConfiguration | Set-CsPersistentChatConfiguration -DefaultChatHistory 100

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

Get-CsPersistentChatConfiguration -Filter "site:*" | Set-CsPersistentChatConfiguration -DefaultChatHistory 100

В примере 4 свойство DefaultChatHistory изменяется для всех коллекций параметров конфигурации сохраняемого чата, журнал чата по умолчанию в которых на данный момент больше 100. Для этого сначала используется командлет Get-CsPersistentChatConfiguration , возвращающий коллекцию всех параметров конфигурации сохраняемого чата, используемых в организации. Эта коллекция передается в командлет Where-Object , который отбирает только те параметры, свойство DefaultChatHistory которых больше (-gt) 100. Отфильтрованная коллекция передается в командлет Set-CsPersistentChatConfiguration , который циклически обрабатывает каждый из элементов в ней и присваивает свойству DefaultChatHistory значение 100.

Get-CsPersistentChatConfiguration | Where-Object {$_.DefaultChatHistory -gt 100} | Set-CsPersistentChatConfiguration -DefaultChatHistory 100

Служба Persistent Chat (заменившая службу групповой беседы, которая использовалась в Microsoft Lync Server 2010) предоставляет организациям возможности обмена сообщениями и совместной работы, аналогичные возможностям в дискуссионных форумах в Интернете: пользователи могут обмениваться сообщениями в режиме реального времени, а также могут снова заходить в сеансы беседы и возобновлять их в любое время. Беседы могут быть основаны на конкретных темах, и доступ к ним может быть открыт либо для всех, либо только для указанного ряда пользователей. Аналогично, отдельные комнаты чата можно настроить так, чтобы любой мог отправлять сообщения, или так, чтобы сообщения могли отправлять только назначенные выступающие.

Служба Persistent Chat управляется, в частности, параметрами конфигурации сохраняемого чата, которые задают, например, число ранее отправленных сообщений, немедленно доступных при входе в комнату чата (журнал чата), или максимальный размер файла, который может быть отправлен в эту службу (или загружен из нее). Эти параметры можно настраивать на глобальном уровне, а также на уровне сайта или службы (т.е. можно получить коллекцию параметров, назначенных отдельному пулу сохраняемого чата).

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

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

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

 

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

Confirm

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

System.Management.Automation.SwitchParameter

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

DefaultChatHistory

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

System.Int16

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

Для DefaultChatHistory может быть задано любое значение от 1 до 500 включительно. По умолчанию установлено значение 30.

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

-Identity "site:Redmond"

Для изменения коллекции, настроенной для области службы, используется следующий синтаксис:

-Identity "service:PersistentChatServer:atl-gc-001.litwareinc.com"

Для изменения глобальной коллекции используется следующий синтаксис:

-Identity "global"

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

Instance

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

System.Management.Automation.PSObject

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

MaxFileSizeKB

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

System.UInt32

Максимальный размер файла (в килобайтах), который может быть отправлен или загружен веб-службой. По умолчанию установлено значение 20000 КБ.

ParticipantUpdateLimit

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

System.UInt32

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

RoomManagementUrl

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

System.String

URL-адрес для администраторов веб-страниц можно использовать для управления отдельными разговорными каналами.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Командлет Set-CsPersistentChatConfiguration принимает в качестве входных данных из конвейера экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.PersistentChat.PersistentChatConfiguration.

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

 
Показ: