Set-CsImFilterConfiguration

Skype for Business Server 2015
 

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

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

Set-CsImFilterConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsImFilterConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Команда, показанная в этом примере, отключает фильтрацию универсальных кодов ресурсов (URI) для конфигурации фильтра мгновенных сообщений с идентификатором site:Redmond. Для этого вызывается командлет Set-CsImFilterConfiguration с параметром Enabled, для которого указано значение $False.

Set-CsImFilterConfiguration -Identity site:Redmond -Enabled $False

В примере 2 в список запрещенных префиксов для конфигурации фильтра мгновенных сообщений с идентификатором site:Redmond добавляется новый префикс универсального кода ресурса (urn:). Для добавления этого префикса вызывается командлет Get-CsImFilterConfiguration , который извлекает конфигурацию с идентификатором site:Redmond. Полученный объект, представляющий эту конфигурацию, сохраняется в переменной с именем $x. После извлечения параметров в строке 2 вызывается метод Add() для добавления префикса urn: в набор префиксов, хранящихся в свойстве Prefixes. При этом изменяется значение ссылки на объект $x. Для изменения самой конфигурации в строке 3 вызывается командлет Set-CsImFilterConfiguration , которому передается единственное значение параметра $x.

$x = Get-CsImFilterConfiguration -Identity site:Redmond
$x.Prefixes.Add("urn:")
Set-CsImFilterConfiguration -Instance $x

В примере 3 выполняются те же действия, что и в примере 2, но в одной строке. В этой команде для добавления префикса urn: в список префиксов используется параметр Prefixes командлета Set-CsImFilterConfiguration . Модификатор списка add служит для добавления этого значения в список Prefixes.

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="urn:"}

В этом примере префикс urn: удаляется из списка префиксов, которые блокируются конфигурацией фильтра мгновенных сообщений для сайта site:Redmond. Этот пример идентичен примеру 3 за тем исключением, что вместо использования модификатора списка add, который добавляет префикс в список, используется модификатор remove, который удаляет префикс.

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="urn:"}

При отправке мгновенных сообщений пользователи могут включать в текст универсальные коды ресурсов (URI), щелкнув которые другие участники беседы могут перейти на определенный веб-сайт или к определенному общему ресурсу. Skype для бизнеса Server 2015 можно настроить так, что гиперссылки с определенными префиксами будут блокироваться или будут неактивны. (Иными словами, участники не смогут перейти на сайт, на который указывает код URI, просто щелкнув ссылку. Они должны скопировать ссылку и вставить ее в адресную строку браузера вручную.)

Командлет Set-CsImFilterConfiguration позволяет изменить список префиксов URI, которые должны отфильтровываться, а также включить или отключить фильтрацию на глобальном уровне или для определенного сайта. С помощью этого командлета можно также изменить различные сообщения с предупреждениями, которые получают пользователи.

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

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

 

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

Action

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

UrlFilterAction

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

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

Block — доставка сообщений, содержащих активные гиперссылки, блокируется, и сервер Skype для бизнеса Server 2015 посылает отправителю сообщение об ошибке.

Warn — сообщения, содержащие активные гиперссылки, доставляются получателям, но в начало каждого такого сообщения добавляется предупреждение. Текст предупреждения можно задать с помощью свойства WarnMessage. Если выбрано значение Warn, но свойство WarnMessage не задано, фильтрация мгновенных сообщений отключается, но значение параметра BlockFileExtension по-прежнему учитывается.

AllowMessage

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

String

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

BlockFileExtension

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

Boolean

Если для этого параметра задано значение True, гиперссылка, которая содержит путь к файлу с расширением, указанным в свойстве Extensions класса Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration (извлекается путем вызова командлета Get-CsFileTransferFilterConfiguration ), блокируется, а отправитель получает сообщение об ошибке. Если задано значение False, никакой особой проверки путей к файлам и расширений не производится.

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

Confirm

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

SwitchParameter

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

Enabled

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

Boolean

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

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

Force

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

SwitchParameter

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

Identity

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

XdsIdentity

Уникальный идентификатор конфигурации фильтра мгновенных сообщений, которую необходимо изменить. Допустимые значения: global или site:<имя_сайта>, где <имя_сайта> — это сайт, к которому применяется конфигурация, например site:Redmond.

IgnoreLocal

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

Boolean

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

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

Instance

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

ImFilterConfiguration

Позволяет передавать ссылку на объект в командлет вместо установки значений для отдельных параметров. Данный командлет принимает объект типа Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration, который можно получить с помощью командлета Get-CsImFilterConfiguration .

Prefixes

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

PSListModifier

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

Список по умолчанию: callto:, file:, ftp., ftp:, gopher:, href, http:, https:, ldap:, mailto:, news:, nntp:, sip:, sips:, tel:, telnet:, www*.

WarnMessage

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

String

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

WhatIf

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

SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration. Принимает входные данные из конвейера в виде объекта конфигурации фильтра мгновенных сообщений.

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

 
Показ: