Get-CsPersistentChatEligiblePrincipal

Skype for Business Server 2015
 

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

Возвращает возможных участников для категории сохраняемого чата (Persistent Chat) или комнаты чата. К возможным участникам относятся разрешенные участники или менеджеры (для категории комнаты чата), а также разрешенные выступающие (только для комнаты чата). Данный командлет впервые появился в Lync Server 2013.

Get-CsPersistentChatEligiblePrincipal -Category <String> <COMMON PARAMETERS>
Get-CsPersistentChatEligiblePrincipal -Room <String> [-Presenters <SwitchParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Filter <String>] [-PersistentChatPoolFqdn <String>] [-ResultSize <Int32>]

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

Get-CsPersistentChatEligiblePrincipal -PersistentChatPoolFqdn "atl-persistentchat-001.litwareinc.com" -Category "ITChat"

В примере 2 возвращаются сведения обо всех возможных ведущих для чата HelpDeskChatRoom.

Get-CsPersistentChatEligiblePrincipal -PersistentChatPoolFqdn "atl-persistentchat-001.litwareinc.com" -Room "HelpDeskChatRoom" -Presenters

В примере 3 показан вариант команды из примера 2. Но в данном примере возвращаются сведения только о выступающих сохраняемого чата, без представления учетных записей пользователей. Для этого сначала используется командлет Get-CsPersistentChatEligiblePrincipal , чтобы получить всех выступающих для комнаты чата HelpDeskChatRoom. Затем эта коллекция по конвейеру передается в командлет Where-Object , который выбирает только тех выступающих, у которых значение свойства PersistentChatPrincipalType не равно (-ne) "user".

Get-CsPersistentChatEligiblePrincipal -PersistentChatPoolFqdn "atl-persistentchat-001.litwareinc.com" -Room "HelpDeskChatRoom" -Presenters | Where-Object {$_.PersistentChatPrincipalType -ne "user"}

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

В категориях чата можно указать определенных пользователей как создателей (создатели — это пользователи, которым разрешено создавать комнаты чата в этой категории). Кроме того, в комнатах чата есть возможность указать пользователей как менеджеров или выступающих. Однако чтобы конкретному пользователю могла быть назначена какая-либо их этих ролей, он должен присутствовать в списке разрешенных участников AllowedMembers для этой категории или комнаты. Список разрешенных участников можно получить с помощью командлетов Get-CsPersistentChatRoom и Get-CsPersistentChatCategory. Однако если в этот список добавлена группа безопасности, подразделение или домен, то имена пользователей, входящих в эту группу, подразделение или домен, не отображаются. Например, если в списке разрешенных участников имеется группа безопасности FinanceManagers, то имена отдельных пользователей, входящих в эту группу, не отображаются; можно видеть только имя группы.

Чтобы увидеть имена всех пользователей в этой группе (а также имена всех пользователей в списке разрешенных участников для категории или комнаты), используйте командлет Get-CsPersistentChatEligiblePrincipal .

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

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

Панель управления Skype для бизнеса Server : функции, выполняемые командлетом Get-CsPersistentChatEligiblePrincipal , недоступны в панели Панель управления Skype для бизнеса Server.

 

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

Category

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

System.String

Имя категории группового чата, для которой нужно получить возможных участников. При вызове командлета Get-CsPersistentChatEligiblePrincipal необходимо использовать либо параметр Category, либо параметр Room. Нельзя использовать оба эти параметра в одной команде.

Room

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

System.String

Имя комнаты группового чата, для которой нужно получить возможных участников. При вызове командлета Get-CsPersistentChatEligiblePrincipal необходимо использовать либо параметр Category, либо параметр Room. Нельзя использовать оба эти параметра в одной команде.

Filter

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

System.String

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

-Filter "*smith*"

Обратите внимание, что параметр Filter может фильтровать только SIP-адреса.

PersistentChatPoolFqdn

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

System.String

Полное доменное имя пула Persistent Chat. Например:

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

Presenters

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

System.Management.Automation.SwitchParameter

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

Этот параметр может использоваться только вместе с параметром Room и возвращает информацию только для чатов, настроенных как аудитории.

ResultSize

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

System.Int32

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

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

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

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

 
Показ: