Get-CsFileTransferFilterConfiguration
上次修改主題的時間： 2012-03-23
傳回組織中的檔案傳輸篩選組態。這些組態是用來封鎖使用者使用 Microsoft Lync Server 2010 用戶端傳輸特定檔案類型 (例如副檔名為 .vbs 或 .ps1 的檔案) 的功能。
語法
Get-CsFileTransferFilterConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsFileTransferFilterConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
傳送立即訊息時，使用者可以在交談中附加及傳送檔案給其他參與者。Lync Server 2010 可以設定為不允許使用 Lync Server 2010 用戶端傳送具有特定副檔名的檔案 (通常是可能證明有害的檔案類型副檔名)。
Get-CsFileTransferFilterConfiguration 指令程式提供一種方法，讓您擷取特定設定集合 (這些設定可在全域範圍或站台範圍設定) 的設定。檔案傳輸篩選組態包括封鎖傳輸的副檔名清單、啟用篩選的程度 (封鎖所有檔案傳輸或僅封鎖具特定副檔名的檔案)，以及是否啟用檔案傳輸篩選。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsFileTransferFilterConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsFileTransferFilterConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
要擷取之檔案傳輸篩選組態的唯一識別碼。若要參考通用設定，請使用此語法：-Identity global。若要參照已設定於站台範圍上的設定，請使用類似下列的語法：-Identity site:Redmond。請注意，指定 Identity 時，無法使用萬用字元值。如果要使用萬用字元，請改用 Filter 參數。 |
Filter |
選用 |
字串 |
可讓您在指定要傳回的檔案傳輸篩選組態時，使用萬用字元。例如，若要傳回在站台範圍的所有檔案傳輸篩選組態，請使用此語法：-Filter "site:*"。根據設計，具有 Identity (唯一可以當做篩選依據的屬性) 開頭字串值為 "site" 的檔案傳輸篩選組態：都是在站台範圍設定的設定。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取檔案傳輸篩選組態，而非從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
Get-CsFileTransferFilterConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsFileTransferFilterConfiguration
範例 1 所示的命令會傳回設為在組織中使用之所有檔案傳輸篩選組態的集合。每當您呼叫不含其他任何參數的 Get-CsFileTransferFilterConfiguration 時，此為預設行為。
-------------------------- 範例 2 --------------------------
Get-CsFileTransferFilterConfiguration -Identity site:Redmond
以上的範例會傳回單一檔案傳輸篩選組態：組態的 Identity 為 site:Redmond。由於識別身分必須是唯一的，因此這個命令絕對不會傳回一個以上的組態。
-------------------------- 範例 3 --------------------------
Get-CsFileTransferFilterConfiguration -Filter site:*
範例 3 會使用 Filter 參數傳回在網站層級上所有檔案傳輸篩選組態的集合。篩選值 "site:*" 會指示 Get-CsFileTransferFilterConfiguration 只傳回 Identity 開頭字串值為 "site:" 的組態。
-------------------------- 範例 4 --------------------------
Get-CsFileTransferFilterConfiguration | Where-Object {$_.Extensions -contains ".xls"}
範例 4 所示的命令只會傳回其禁止副檔名清單中包含 .xls 的檔案傳輸篩選組態。若要這樣做，首先會使用 Get-CsFileTransferFilterConfiguration 傳回設定為在組織中使用之所有組態的集合。接著，該集合會傳送到 Where-Object 指令程式，以套用篩選，這個篩選會將傳回的資料限制為 Extensions 屬性包含 (-contains) 字串值 ".xls" 的集合。
-------------------------- 範例 5 --------------------------
Get-CsFileTransferFilterConfiguration | Where-Object {$_.Enabled -eq $False}
上述命令會傳回所有目前已停用的檔案傳輸篩選組態。若要完成此工作，系統會使用 Get-CsFileTransferFilterConfiguration 傳回設定為在組織中使用之所有組態的集合。然後，將此集合傳送至 Where-Object 指令程式，該指令程式只選取其 Enabled 屬性等於 (-eq) True ($True) 的組態。
-------------------------- 範例 6 --------------------------
Get-CsFileTransferFilterConfiguration -Identity Global | Select-Object -ExpandProperty Extensions
範例 6 會顯示通用檔案傳輸篩選組態所禁止的完整副檔名清單。此命令的開頭是呼叫 Get-CsFileTransferFilterConfiguration 指令程式，以指定 Global 組態集合。然後，傳回的資訊會傳送到 Select-Object 指令程式，以使用 ExpandProperty 參數來「展開」Extensions 屬性的值。如此會產生完整副檔名清單，顯示於畫面上，每行一個副檔名。