Get-CsImFilterConfiguration

Skype for Business Server 2015
 

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

Возвращает фильтры ссылок системы обмена мгновенными сообщениями, настроенные в организации. Такие фильтры используются для предотвращения отправки пользователями мгновенных сообщений, содержащих гиперссылки с определенными префиксами (например, ссылки с префиксом http или telnet). Это означает, что в соответствии с используемыми параметрами любой универсальный код ресурса (URI) с префиксом по одной из этих схем будет преобразован в гиперссылку, которую невозможно нажать, или будет полностью удален. Данный командлет впервые появился в Lync Server 2010.

Get-CsImFilterConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsImFilterConfiguration [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>]

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

Get-CsImFilterConfiguration

В примере 2 извлекаются параметры для одного фильтра системы обмена мгновенными сообщениями. Эти параметры имеют удостоверение site:Redmond. Поскольку удостоверения должны быть уникальны, данная команда никогда не извлекает более одной конфигурации.

Get-CsImFilterConfiguration -Identity site:Redmond

В примере 3 с помощью параметра Filter извлекается коллекция всех фильтров системы обмена мгновенными сообщениями, которые настроены на уровне узла. Строка с подстановочным знаком site:* указывает, что командлет Get-CsImFilterConfiguration должен вернуть только те конфигурации фильтров системы обмена мгновенными сообщениями, удостоверение которых начинается со строки site:.

Get-CsImFilterConfiguration -Filter site:*

В примере 4 выполняется "разворачивание" значения свойства Prefixes глобальной конфигурации фильтров системы обмена мгновенными сообщениями при его выводе на экран; это просто означает, что свойство и его значения будут отображаться в более удобном для чтения формате. Для выполнения этой задачи сначала используется командлет Get-CsImFilterConfiguration для извлечения глобальной конфигурации фильтров системы обмена мгновенными сообщениями. (Обратите внимание, что вызов Get-CsImFilterConfiguration заключен в скобки. Это указывает, что Windows PowerShell сначала должен выполнить команды, заключенные в скобки, а затем продолжить выполнение остальных команд.) После извлечения конфигурации значение свойства Prefixes отображается на экране так, что каждый префикс располагается на отдельной строке.

(Get-CsImFilterConfiguration -Identity Global).Prefixes

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

Командлет Get-CsImFilterConfiguration извлекает все параметры фильтрации URI из мгновенных сообщений. При вызове без параметров командлет Get-CsImFilterConfiguration возвращает все параметры фильтрации URI в системе обмена мгновенными сообщениями, как глобальные, так и на уровне узла. Можно также указывать удостоверение, чтобы отображать параметры для конкретного узла (или глобальные параметры).

 

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

Filter

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

System.String

Выполняет поиск с использованием подстановочных знаков тех конфигураций, которые соответствуют указанному шаблону удостоверения. Например, извлекает все параметры с удостоверениями, которые начинаются со строки site* (т.е. все параметры на уровне узла).

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

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

LocalStore

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

System.Management.Automation.SwitchParameter

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

Командлет Get-CsImFilterConfiguration возвращает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

 
Показ: