Get-CsPersistentChatRoom

Skype for Business Server 2015
 

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

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

Get-CsPersistentChatRoom [-Addin <String>] [-Category <String>] [-ChatContentExceedsMB <Int32>] [-Disabled <$true | $false>] [-Filter <String>] [-Invitations <False | Inherit>] [-Manager <String>] [-Member <String>] [-PersistentChatPoolFqdn <String>] [-Privacy <Open | Closed | Secret>] [-ResultSize <Int32>] [-SearchDescription <SwitchParameter>] [-Type <Normal | Auditorium>] <COMMON PARAMETERS>
Get-CsPersistentChatRoom [-Identity <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-AsObject <SwitchParameter>]

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

Get-CsPersistentChatRoom

В примере 2 возвращаются данные об одном разговорном канале сохраняемых сеансов бесед (с идентификатором atl-cs-001.litwareinc.com\ITChatRoom).

Get-CsPersistentChatRoom -Identity "atl-cs-001.litwareinc.com\ITChatRoom"

В примере 3 возвращаются данные обо всех разговорных каналах сохраняемых сеансов бесед, настроенных для пула atl-cs-001.litwareinc.com.

Get-CsPersistentChatRoom -PersistentChatPoolFqdn "atl-cs-001.litwareinc.com"

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

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

Командлет Get-CsPersistentChatRoom позволяет получить сведения о всех комнатах чата, используемых в организации.

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

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

 

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

Addin

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

System.String

Возвращает разговорные каналы, связанные с указанной надстройкой для разговорных каналов.

Обратите внимание, что в одной команде можно указать только одну надстройку.

AsObject

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

System.Management.Automation.SwitchParameter

Если указано, при отображении пользователей из списков Managers или Presenters используются отображаемые имена из Active Directory. Если не указано, при отображении этих пользователей используются SIP-адреса.

Category

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

System.String

Возвращает данные обо всех разговорных каналах сохраняемых сеансов бесед из определенной категории. Например:

-Category "ITChat"

В параметре Category можно указать только одну категорию. Кроме того, нельзя использовать параметры PersistentChatPoolFqdn, Filter или Identity совместно с параметром Category в рамках одной команды.

ChatContentExceedsMB

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

System.Int32

Возвращает разговорные каналы, содержимое разговоров в которых превышает указанное значение (в мегабайтах).

Disabled

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

System.Boolean

Позволяет искать активные разговорные каналы (с помощью значения $False) или отключенные каналы (значение $True).

Filter

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

System.String

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

-Filter {Name –like "ITChat"}

Этот синтаксис возвращает данные только о разговорных каналах с именем ITChat.

Identity

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

System.String

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

-Identity "atl-gc-001.litwareinc.com\RedmondChatRoom"

Параметры Category, Filter или PersistentChatPoolFqdn нельзя использовать совместно с параметром Identity в рамках одной команды. При вызове командлета Get-CsPersistentChatRoom без параметров он вернет данные о всех комнатах чата, используемых в организации.

Invitations

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

Microsoft.Rtc.Management.Chat.Cmdlets.ChatRoomInvitations

Возвращает комнаты чата, в которых используются приглашения (с помощью значения Inherit), или комнаты, в которых приглашения не используются (значение False).

Manager

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

System.String

Возвращает разговорные каналы, управляемые указанным пользователем. Например:

-Manager "sip:kenmyer@litwareinc.com"

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

Member

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

System.String

Возвращает разговорные каналы, членом которых является указанный пользователь. Например:

-Member "sip:kenmyer@litwareinc.com"

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

PersistentChatPoolFqdn

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

System.String

Возвращает данные обо всех разговорных каналах сохраняемых сеансов бесед, настроенных для определенного пула сохраняемых сеансов бесед. Например:

-PersistentChatPoolFqdn "atl-gc-001.litwareinc.com"

Параметры Category, Filter или Identity нельзя использовать совместно с параметром PersistentChatPoolFqdn в рамках одной команды.

Privacy

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

Microsoft.Rtc.Management.Chat.Cmdlets.ChatRoomPrivacy

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

* Open (любой пользователь может находить разговорный канал, выполняя поиск в каталоге, и любой может принимать участие в действиях этого канала)

* Secret (только члены разговорного канала могут находить этот канал, выполняя поиск в каталоге, и только члены разговорного канала могут участвовать в его действиях)

* Closed (любой пользователь может находить разговорный канал, выполняя поиск в каталоге, но только члены канала могут принимать участие в его действиях)

ResultSize

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

System.Int32

Позволяет ограничить число записей, возвращаемых командлетом. Например, чтобы вернуть семь разговорных каналов (независимо от их количества в лесу), следует указать параметр ResultSize со значением 7. Обратите внимание, что вернуть семь каких-либо строго определенных каналов невозможно.

В качестве размера результатов может быть указано любое целое число в диапазоне от 0 до 2147483647 включительно. При задании значения "0" команда будет выполняться, но данные возвращаться не будут. Если указать для параметра ResultSize значение 7, а каналов в лесу только три, команда вернет их и завершит работу без ошибок.

SearchDescription

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

System.Management.Automation.SwitchParameter

Позволяет искать определенную строку текста в имени или описании разговорных каналов. Чтобы искать текст как в имени, так и описании, укажите как параметр SearchDescription, так и параметр Filter. Например:

-SearchDescription –Filter "IT chat room"

Type

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

Microsoft.Rtc.Management.Chat.Cmdlets.ChatRoomType

Возвращает разговорные каналы определенного типа. Допустимые значения:

* Normal (каналы, в которых публиковать сообщения могут все члены).

* Auditorium (каналы, в которых только докладчики могут публиковать сообщения).

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

Командлет Get-CsPersistentChatRoom возвращает экземпляры объекта Microsoft.Rtc.Management.PersistentChat.Cmdlets.ChatRoomObject.

 
Показ: