New-CsImFilterConfiguration

Skype for Business Server 2015
 

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

Создает конфигурацию фильтра обмена мгновенными сообщениями (IM). IM-фильтры используются, чтобы не позволять пользователям отправлять мгновенные сообщения с активными гиперссылками. Данный командлет впервые появился в Lync Server 2010.

New-CsImFilterConfiguration -Identity <XdsIdentity> [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-InMemory <SwitchParameter>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

В примере 1 командлет New-CsImFilterConfiguration используется для создания новой конфигурации IM-фильтра с удостоверением site:Redmond. (Так как дополнительные параметры не указаны, конфигурация создается со значениями по умолчанию.)

New-CsImFilterConfiguration -Identity site:Redmond

В этой команде командлет New-CsImFilterConfiguration используется для создания конфигурации IM-фильтра с удостоверением site:Redmond. Так как указан параметр Prefixes, новая конфигурация будет содержать все значения по умолчанию, в том числе префиксы фильтра по умолчанию, а также два дополнительных префикса URI: rtsp: и urn:. Эти префиксы добавляются в список по умолчанию с помощью модификатора списка add.

New-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="rtsp:","urn:"}

В этой команде командлет New-CsFileTransferFilterConfiguration используется для создания новой конфигурации IM-фильтра с удостоверением site:Redmond. Этот пример аналогичен примеру 2, но модификатор списка replace используется вместо модификатора add. Это означает, что все префиксы URI по умолчанию будут заменены на эти два префикса (rtsp: и urn:). Поэтому только URI-адреса с префиксами rtsp: и urn: будут фильтроваться в мгновенных сообщениях для сайта Redmond.

New-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{replace="rtsp:","urn:"}

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

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

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

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

 

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

Identity

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

XdsIdentity

Уникальный идентификатор, указывающий область действия конфигурации IM-фильтра. Глобальные параметры существуют по умолчанию, и их нельзя воссоздать с помощью командлета New-CsImFilterConfiguration , но вы можете создать параметры на уровне сайта, указав удостоверение сайта:<имя_сайта>, где <имя_сайта> — это имя сайта, к которым применяются параметры (например, site:Redmond).

Полный тип данных: Microsoft.Rtc.Management.Xds.XdsIdentity

Action

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

UrlFilterAction

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

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

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

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

По умолчанию: разрешить, если сообщение не содержит больше 1000 URL-адресов, иначе по умолчанию используется значение Block.

Полный тип данных: Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.UrlFilterAction

AllowMessage

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

Строка

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

BlockFileExtension

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

Логическое

Если задано значение True, гиперссылка, содержащая путь к файлу с расширением, заданным в свойстве Extensions, которое определено в конфигурации фильтра передачи файлов (ее можно получить с помощью командлета Get-CsFileTransferFilterConfiguration ), блокируется, а отправителю возвращается сообщение об ошибке. Если задано значение False, расширения файлов не проверяются.

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

Confirm

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

SwitchParameter

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

Enabled

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

Логическое

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

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

Force

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

SwitchParameter

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

IgnoreLocal

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

Логическое

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

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

InMemory

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

SwitchParameter

Создает ссылку на объект без фиксации объекта в качестве постоянного изменения. Если выходные данные этого командлета, вызванного с помощью указанного параметра, назначаются переменной, можно внести изменения в свойства ссылки на объект и затем зафиксировать эти изменения, вызвав соответствующий командлет Set-<cmdlet> .

Prefixes

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

PSListModifier

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

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

WarnMessage

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

Строка

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

WhatIf

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

SwitchParameter

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

Создает объект типа Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

 
Показ: