New-CsFileTransferFilterConfiguration

Skype for Business Server 2015
 

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

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

New-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

В примере 1 с помощью командлета New-CsFileTransferFilterConfiguration создается новая конфигурация фильтра передачи файлов мгновенных сообщений с параметром Identity, имеющим значение site:Redmond. Так как никакие параметры не указываются, для создания конфигурации будут использованы значения по умолчанию.

New-CsFileTransferFilterConfiguration -Identity site:Redmond

В этой команде с помощью командлета New-CsFileTransferFilterConfiguration создается новая конфигурация фильтра передачи файлов с параметром Identity, имеющим значение site:Redmond. Так как был задан параметр Extensions, новая конфигурация будет содержать все значения по умолчанию плюс дополнительное расширение файла: PS1. Это новое расширение добавляется с помощью параметра Extensions и модификатора списка Add, за которым следует добавляемое расширение файла. (Обратите внимание, что в расширение файла необходимо включить точку.) Чтобы добавить несколько расширений файлов, просто разделите их запятыми: @{Add=".ps1",".ps2",".ps3"}

New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Add=".ps1"}

В примере 3 с помощью командлета New-CsFileTransferFilterConfiguration создается новая конфигурация фильтра передачи файлов с идентификатором Identity, имеющим значение site:Redmond. Этот пример аналогичен примеру 2, за исключением использования модификатора списка Replace вместо модификатора Add. Это означает, что весь набор расширений будет заменен двумя задаваемыми расширениями файлов: .vbs и .ps1. В этом случае на сайте Redmond будут блокироваться только файлы с расширениями VBS и PS1.

New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Replace=".vbs",".ps1"}

В примере 4 показывается использование параметра InMemory для создания конфигурации фильтра передачи файлов, который изначально размещается только в памяти. Для этого первая команда в примере использует командлет New-CsFileTransferFilterConfiguration и параметр InMemory, чтобы создать новую конфигурацию фильтра передачи файлов с параметром Identity site:Redmond. В этот момент времени новые настройки существуют только в памяти, для управления пользователями сайта Redmond пока и дальше будут использоваться глобальные настройки фильтра передачи файлов.

Во второй команде значение свойства Action для этого хранящегося в памяти экземпляра устанавливается равным BlockAll. Наконец, третья команда в этом примере использует командлет Set-CsFileTransferFilterConfiguration , чтобы создать новую коллекцию настроек и применить их к сайту Redmond.

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond -Action "BlockAll"
$x = New-CsFileTransferFilterConfiguration -Identity site:Redmond -InMemory 
$x.Action = "BlockAll"
Set-CsFileTransferFilterConfiguration -Instance $x

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

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

Обратите внимание, что на глобальном уровне невозможно создать новую конфигурацию фильтра передачи файлов. Но командлет Set-CsFileTransferFilterConfiguration можно использовать для изменения глобальных настроек. Аналогичным образом, нельзя создать новую конфигурацию для сайта, если такая конфигурация для сайта уже определена — при подобной попытке выполнение команды закончится неудачей.

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор, назначаемый конфигурации фильтра передачи файлов. Идентификатор Identity для новой конфигурации просто представляет собой префикс "site:", за которым идет имя сайта. Например, чтобы создать новую конфигурацию для сайта Redmond, будет использоваться следующий синтаксис: -Identity site:Redmond.

Action

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

Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileFilterAction

Определяет действие, предпринимаемое, если фильтрация передачи файлов включена. Если задано значение BlockAll, любая передача файлов запрещена, независимо от расширения файла. Если задано значение Block (значение по умолчанию), передача файлов будет разрешена, если расширение файла отсутствует в списке запрещенных типов файлов, перечисленных в свойстве Extensions.

Чтобы снять ограничения на передачу файлов (то есть разрешить пользователям обмениваться файлами любых типов, независимо от расширения файла), задайте для свойства Enabled этой политики значение False.

Confirm

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

System.Management.Automation.SwitchParameter

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

Enabled

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

System.Boolean

Включает или отключает фильтрацию передачи файлов. Если значение этого параметра равно True, файлы с указанными расширениями (или все файлы, в зависимости от значения свойства Action) не могут быть переданы клиентом Skype для бизнеса Server 2015. Если значение этого параметра равно False, может быть передан любой файл.

По умолчанию: True.

Extensions

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

System.Management.Automation.PSListModifier

Список расширений файлов, которые будут заблокированы. При попытке использовать клиент Skype для бизнеса Server 2015 для передачи файла с расширением из этого списка, передача будет заблокирована и файл не будет передан. Список игнорируется, если для параметра Action задано значение BlockAll (блокируются передачи всех файлов) или если для параметра Enabled задано значение False (не блокируются передачи никаких файлов).

По умолчанию в список свойства Extensions включены следующие расширения файлов: .ade, .adp, .app, .asp, .bas, .bat, .cer, .chm, .cmd, .com, .cpl, .crt, .csh, .exe, .fxp, .grp, .hlp, .hta, .inf, .ins, .isp, .its, .js, .jse, .ksh, .lnk, .mad, .maf, .mag, .mam, .maq, .mar, .mas, .mat, .mau, .mav, .maw, .mda, .mdb, .mde, .mdt, .mdw, .mdz, .msc, .msi, .msp, .mst, .ocx, .ops, .pcd, .pif, .pl, .pnp, .prf, .prg, .pst, .reg, .scf, .scr, .sct, .shb, .shs, .tmp, .url, .vb, .vbe, .vbs, .vsd, .vsmacros, .vss, .vst, .vsw, .ws, .wsc, .wsf, .wsh

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

 
Показ: