Get-CsFileTransferFilterConfiguration

Skype for Business Server 2015
 

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

Возвращает конфигурации фильтров передачи файлов, используемые в организации. Эти конфигурации используются для блокирования передачи определенных типов файлов (например, файлы с расширением VBS или PS1) с помощью клиента Skype для бизнеса Server 2015. Данный командлет впервые появился в Lync Server 2010.

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

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

Get-CsFileTransferFilterConfiguration

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

Get-CsFileTransferFilterConfiguration -Identity site:Redmond

Команда, показанная в примере 3, использует параметр Filter, чтобы получить коллекцию всех конфигураций фильтров передачи файлов на уровне сайта. Значение "site:*" параметра Filter указывает командлету Get-CsFileTransferFilterConfiguration на то, что необходимо вернуть только те конфигурации, у которых идентификатор начинается со строки "site:".

Get-CsFileTransferFilterConfiguration -Filter site:*

Команда, показанная в примере 4, возвращает только те конфигурации фильтров передачи файлов, в списках запрещенных расширений файлов которых содержится значение XLS. Чтобы получить коллекцию всех конфигураций, используемых в организации, вызывается командлет Get-CsFileTransferFilterConfiguration . Полученная коллекция передается командлету Where-Object , который применяет фильтр, ограничивающий возвращаемые данные конфигурациями, у которых свойство Extensions содержит (-contains) строковое значение ".xls".

Get-CsFileTransferFilterConfiguration | Where-Object {$_.Extensions -contains ".xls"}

Команда, показанная в примере 5, возвращает все конфигурации фильтров передачи файлов, которые в настоящий момент отключены. Чтобы получить коллекцию всех конфигураций, используемых в организации, вызывается командлет Get-CsFileTransferFilterConfiguration . Полученная коллекция передается командлету Where-Object , который выбирает только те конфигурации, у которых свойство Enabled имеет значение (-eq) True ($True).

Get-CsFileTransferFilterConfiguration | Where-Object {$_.Enabled -eq $False}

В примере 6 показан полный список расширений файлов, запрещенных глобальной конфигурацией фильтров передачи файлов. Команда начинается с вызова командлета Get-CsFileTransferFilterConfiguration с параметром Global. Полученные данные передаются командлету Select-Object , который использует параметр ExpandProperty для расширения значения свойства Extensions. В результате, на экране отображается полный список расширений файлов.

Get-CsFileTransferFilterConfiguration -Identity Global | Select-Object -ExpandProperty Extensions

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

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

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

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

 

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

Filter

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

System.String

Позволяет использовать подстановочные знаки при указании возвращаемых конфигураций фильтров передачи файлов. Например, чтобы получить все конфигурации фильтров передачи файлов на уровне сайта, используйте следующий синтаксис: -Filter "site:*". Конфигурации фильтров передачи файлов, у которых идентификатор (одно свойство фильтрации) начинается со строки "site:", преднамеренно были настроены на уровне сайта.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор извлекаемой конфигурации фильтров передачи файлов. Чтобы извлечь параметры на глобальном уровне, используйте следующий синтаксис: -Identity global. Чтобы извлечь параметры на уровне сайта, используйте синтаксис, похожий на этот: -Identity site:Redmond. Обратите внимание, что при указании идентификатора нельзя использовать подстановочные знаки. Если вы хотите использовать подстановочные знаки, используйте параметр Filter.

LocalStore

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

System.Management.Automation.SwitchParameter

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

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

 
Показ: