Set-CsPersistentChatRoom

Skype for Business Server 2015
 

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

Изменяет существующий чат Persistent Chat. Чат — это обсуждение, обычно касающееся конкретной темы. Данный командлет впервые появился в Lync Server 2013.

Set-CsPersistentChatRoom -Instance <ChatRoom> <COMMON PARAMETERS>
Set-CsPersistentChatRoom -Identity <String> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Addin <String>] [-AsObject <SwitchParameter>] [-Category <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Disabled <$true | $false>] [-Force <SwitchParameter>] [-Invitations <False | Inherit>] [-Managers <PSListModifier>] [-Members <PSListModifier>] [-Name <String>] [-Presenters <PSListModifier>] [-Privacy <Open | Closed | Secret>] [-Type <Normal | Auditorium>] [-WhatIf [<SwitchParameter>]]

Команда в примере 1 отключает чат Persistent Chat с параметром Identity, равным atl-cs-001.litwareinc.com\ITChatRoom.

Set-CsPersistentChatRoom -Identity "atl-cs-001.litwareinc.com\ITChatRoom" -Disabled $True

В примере 2 отключаются все комнаты сохраняемого чата в пуле atl-cs-001.litwareinc.com. Для этого сначала выполняется командлет Get-CsPersistentChatRoom с параметром Identity, который возвращает список всех комнат чата, заданных для пула atl-cs-001.litwareinc.com. Затем эти комнаты чата передаются в командлет Set-CsPersistentChatRoom , который устанавливает свойство Disabled для каждой комнаты чата в значение True ($True).

Get-CsPersistentChatRoom -PersistentChatPoolFqdn "atl-cs-001.litwareinc.com" | Set-CsPersistentChatRoom -Disabled $True

В примере 3 отключаются все комнаты сохраняемого чата в организации. Для этого сначала выполняется командлет Get-CsPersistentChatRoom без параметров, который возвращает коллекцию всех комнат сохраняемого чата. Затем эта коллекция передается в командлет Set-CsPersistentChatRoom , который отключает все комнаты чата в коллекции.

Get-CsPersistentChatRoom | Set-CsPersistentChatRoom -Disabled $True

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

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

Командлет Set-CsPersistentChatRoom позволяет изменять любые (или все) комнаты чата, настроенные для использования в организации. Сюда входит назначение менеджеров и ведущих в комнате чата.

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

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

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

 

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

Identity

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

System.String

Уникальный идентификатор изменяемого чата Persistent Chat. Идентификатор Identity для чата содержит пул Persistent Chat, в котором настроен чат, и имя чата, например:

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

Instance

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

Microsoft.Rtc.Management.Chat.Cmdlets.ChatRoom

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

Addin

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

System.String

Имя надстройки сохраняемого чата (если имеется), связанной с комнатой чата. Надстройка сохраняемого чата — это настраиваемая веб-страница, которую можно внедрять в клиент сохраняемого чата. Надстройки можно создавать с помощью командлета New-CsPersistentChatAddin .

AsObject

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

System.Management.Automation.SwitchParameter

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

Category

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

System.String

Категория, в которой располагается чат, например:

-Category "IT"

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Description

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

System.String

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

Disabled

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

System.Boolean

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

Force

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

System.Management.Automation.SwitchParameter

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

Invitations

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

Microsoft.Rtc.Management.Chat.Cmdlets.ChatRoomInvitations

Указывает, будут ли наследоваться приглашения для чатов в этой категории. В частности, это означает, что пользователи в списке участников будут автоматически получать приглашение присоединиться к новому чату в момент его создания. Если этот параметр имеет значение False, приглашения для чата действовать не будут. Если параметр имеет значение Inherit, для чата будет использоваться параметр Invitations, указанный для его категории.

Managers

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

System.Management.Automation.PSListModifier

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

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

-Managers @{Add="sip:kenmyer@litwareinc.com"}

Можно добавить несколько пользователей, отделив запятыми их адреса SIP:

-Managers @{Add="sip:kenmyer@litwareinc.com", "sip:pilar@litwareinc.com"}

Чтобы удалить пользователя из списка Managers, используйте метод Remove:

-Managers @{Remove="sip:kenmyer@litwareinc.com"}

Чтобы удалить всех пользователей из списка Managers, присвойте свойству Managers значение NULL:

-Managers $Null

Помимо работы с отдельными пользователями также можно работать с целыми организационными подразделениями. Например, следующая команда добавляет всех пользователей в ИТ-департаменте в список управляющих:

-Managers @{Add="OU=IT,DC=litwareinc,DC=com"}

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

-Managers @{Add="CN=ChatSupportGroup,OU=IT,DC=litwareinc,DC=com"}

Members

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

System.Management.Automation.PSListModifier

Список пользователей, которые могут обращаться к чату. Если свойство Members имеет значение NULL, то чат наследует список участников от своей категории Persistent Chat.

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

-Members @{Add="sip:kenmyer@litwareinc.com"}

Можно добавить несколько пользователей, отделив запятыми их адреса SIP:

-Members @{Add="sip:kenmyer@litwareinc.com", "sip:pilar@litwareinc.com"}

Чтобы удалить пользователя из списка Members, используется метод Remove:

-Members @{Remove="sip:kenmyer@litwareinc.com"}

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

-Members $Null

Помимо работы с отдельными пользователями также можно работать с целыми организационными подразделениями. Например, следующая команда добавляет всех пользователей в ИТ-департаменте в список Members:

-Members @{Add="OU=IT,DC=litwareinc,DC=com"}

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

-Members @{Add="CN=ChatSupportGroup,OU=IT,DC=litwareinc,DC=com"}

Name

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

System.String

Имя чата Persistent Chat. Имена должны быть уникальными для каждого пула Persistent Chat.

Presenters

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

System.Management.Automation.PSListModifier

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

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

-Presenters @{Add="sip:kenmyer@litwareinc.com"}

Можно добавить несколько пользователей, отделив запятыми их адреса SIP:

-Presenters @{Add="sip:kenmyer@litwareinc.com", "sip:pilar@litwareinc.com"}

Чтобы удалить пользователя из списка Presenters, используйте метод Remove:

-Presenters @{Remove="sip:kenmyer@litwareinc.com"}

Чтобы удалить всех пользователей из списка Presenters, присвойте свойству Presenters значение NULL:

-Presenters $Null

Помимо работы с отдельными пользователями также можно работать с целыми организационными подразделениями. Например, следующая команда добавляет всех пользователей в ИТ-департаменте в список докладчиков:

-Presenters @{Add="OU=IT,DC=litwareinc,DC=com"}

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

-Presenters @{Add="CN=ChatSupportGroup,OU=IT,DC=litwareinc,DC=com"}

Privacy

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

Microsoft.Rtc.Management.Chat.Cmdlets.ChatRoomPrivacy

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

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

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

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

Type

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

Microsoft.Rtc.Management.Chat.Cmdlets.ChatRoomType

Указывает, имеет ли чат свойство Normal (когда публиковать сообщения могут все участники) или Auditorium (когда публиковать сообщения могут только докладчики). Например:

-Type "Auditorium"

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: