Set-CsFileTransferFilterConfiguration
上次修改主題的時間： 2012-03-26
修改檔案傳輸篩選組態設定的集合。檔案傳輸篩選設定用於封鎖使用者使用 Microsoft Lync Server 2010 指令程式傳輸某些檔案類型 (例如，副檔名為 .vbs 或 .ps1 的檔案) 的能力。
語法
Set-CsFileTransferFilterConfiguration [-Identity <XdsIdentity>] [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsFileTransferFilterConfiguration [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
詳細描述
傳送立即訊息時，使用者可以附加並傳送檔案給交談中的其他參與者。可設定 Lync Server 2010，含有某些副檔名的檔案便不允許從用戶端傳送，通常是證實可能有害的副檔名類型。
使用者使用 Lync Server 2010 用戶端傳輸檔案的能力，是由套用於通用或 (選擇性) 站台範圍的檔案傳輸篩選組態設定所決定。Set-CsFileTransferFilterConfiguration 指令程式允許您修改現有的檔案傳輸篩選組態。您可以利用新增或移除副檔名或是建立新的清單，來修改副檔名清單。您也可以使用這個指令程式變更是否要啟用檔案傳輸篩選及其層級 (只封鎖副檔名符合 Extensions 清單的檔案，或是封鎖全部檔案)。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsFileTransferFilterConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsFileTransferFilterConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
您要修改之檔案傳輸組態的唯一識別碼。這個值可以是 global 或 site:<site name>，<site name> 是要套用設定的站台之名稱，例如 site:Redmond。 如果未指定此參數，依預設，Set-CsFileTransferFilterConfiguration 會更新通用設定。 |
Instance |
選用 |
FileTransferFilterConfiguration |
允許您將物件參考傳遞給指令程式，而非設定個別的參數值。此物件的類型必須是 FileTransferFilterConfiguration，並可由呼叫 Get-CsFileTransferFilterConfiguration 指令程式擷取。 |
Action |
選用 |
字串 |
決定啟用這個檔案傳輸篩選組態時要採取的動作。如果設為 BlockAll，則不論副檔名為何，都會禁止所有檔案傳輸。如果設為 Block (預設值)，則允許檔案傳輸，除非副檔名是 Extensions 屬性所列出之禁止的檔案類型之一。 若要允許無限制的檔案傳輸 (也就是，允許使用者交換任何類型檔案 (不論副檔名為何)，請將此原則的 Enabled 屬性設為 False。 |
Enabled |
選用 |
布林值 |
啟用或停用檔案傳輸篩選。如果此參數設為 True，則無法從用戶端傳輸含有指定副檔名的檔案 (或全部檔案，視 Action 屬性值而定)。如果此參數設為 False，則可傳輸任何檔案。 預設值：True。 |
Extensions |
選用 |
字串清單 |
要封鎖的副檔名清單。如果嘗試使用 Lync Server 2010 用戶端來傳輸具有符合此清單中其中一個副檔名的檔案，則會封鎖該傳輸，而且不會傳輸該檔案。如果 Action 設為 BlockAll (封鎖所有檔案傳輸) 或 Enabled 設為 False (不封鎖任何檔案傳輸)，則會略過此清單。 依預設，下列副檔名包含在 Extensions 屬性的 Default 中：.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 |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 物件。接受檔案傳輸篩選組態物件管線傳送的輸入。
傳回類型
這個指令程式不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Enabled $False
範例 1 所示的命令會停用 Redmond 站台 (亦即，Identity 為 site:Redmond 的檔案傳輸篩選組態) 的檔案傳輸篩選。為了完成這項工作，命令會包含 Enabled 參數，並設為 $False。
-------------------------- 範例 2 --------------------------
Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Add=".ps1"}
上述命令會將副檔名 (.ps1，Windows PowerShell 指令碼的副檔名) 新增至 Redmond site 站台禁止的副檔名清單。若要新增副檔名，Set-CsFileTransferFilterConfiguration 會使用 Extensions 參數和 Add list 修改程式。修改程式將指定的副檔名 -- .ps1 -- 新增至禁止的副檔名清單。若要使用單一命令新增多個副檔名，只要以逗號分隔多個副檔名即可：@{Add=".ps1",".ps2",".ps3"}。請注意，指定副檔名時必須包含逗點。
-------------------------- 範例 3 --------------------------
Get-CsFileTransferFilterConfiguration | Set-CsFileTransferFilterConfiguration -Extensions @{Add=".ps1"}
在範例 3 中，.ps1 副檔名被新增至目前用於組織之所有檔案傳輸篩選組態的 Extensions 清單。為了執行這項作業，會先呼叫不含任何其他參數的 Get-CsFileTransferFilterConfiguration，以便傳回目前使用中的所有檔案傳輸篩選組態集合。該集合便會傳送到 Set-CsFileTransferFilterConfiguration，此指令程式會新增 .ps1 副檔名至集合中的每一個項目。
-------------------------- 範例 4 --------------------------
Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Remove=".ps1"}
在上述範例中，將副檔名 .ps1 從 Redmond 站台的檔案傳輸篩選組態所封鎖的副檔名清單移除。這個範例和範例 3 相同，除了它不呼叫 Add list 修改程式以新增副檔名至清單，而是呼叫 Remove list 修改程式，從該清單中移除副檔名。
-------------------------- 範例 5 --------------------------
$a = Get-CsFileTransferFilterConfiguration -Identity site:Redmond
$a.Extensions.Remove(".ps1")
Set-CsFileTransferFilterConfiguration -Instance $a
範例 5 執行的動作和範例 4 相同：將副檔名 .ps1從 Redmond 站台的檔案傳輸篩選副檔名清單中移除。不過在此例中，我們先擷取 site:Redmond 的檔案傳輸篩選組態，然後將輸出指派至變數 $a。$a 現在包含 Redmond 站台的組態。接下來，我們擷取 $a 的 Extensions 屬性，即 site:Redmond 的 Extensions 屬性 ($a.Extensions)。這個屬性包含副檔名清單。Extensions 屬性後就是呼叫 Remove 方法 ($a.Extensions.Remove)。我們將值 .ps1 傳遞到 Remove 方法；這會從 Extension 屬性的清單中移除副檔名。不過，這只會從變數 $a 的記憶體所儲存的組態中移除副檔名。若要變更資料庫，必須呼叫 Set-CsFileTransferFilterConfiguration，將 $a 傳遞至 Instance 參數。