New-CsDiagnosticsFilter
上次修改主題的時間： 2012-03-23
建立與診斷組態設定搭配使用的新診斷篩選。診斷組態設定可用來決定是否在您的 Microsoft Lync Server 2010 記錄檔中，記錄進出某個網域或統一資源識別項 (URI) 的流量。
語法
New-CsDiagnosticsFilter [-Enabled <$true | $false>] [-ExcludeConferenceMessages <$true | $false>] [-ExcludePresenceNotifications <$true | $false>] [-ExcludeRegisterMessages <$true | $false>] [-ExcludeSubscribeMessages <$true | $false>] [-Fqdn <PSListModifier>] [-Uri <PSListModifier>]
詳細描述
如果您啟用 Lync Server 2010 記錄功能，則這些記錄檔中預設會包含進出任何網域或 URI 的流量。這可確保記錄檔中會盡量記錄最多的資訊。
換句話說，這也會產生資訊過多的情況。例如，當遇到特定網域的連線問題時，需要將記錄範圍限制在您網路與該網路間的流量；這樣您才能更容易識別相關記錄，進而更輕鬆地診斷並修正問題。
診斷組態設定讓您可以指定記錄檔中要記錄的網域或 URI；例如，您可能只想記錄指定網域的來回流量。除了通用設定外，Lync Server 可讓您在站台範圍或服務範圍 (針對 Edge Server 或登錄器服務) 建立診斷設定。因此，除了可以將設定套用至您的其他站台外，您也可以將不同設定套用至 Redmond 站台。
New-CsDiagnosticsFilter 讓您能將篩選新增至診斷設定的集合中。此集合包含將在記錄檔中記錄其流量的網域與 URI。如果已啟用篩選，將只會記錄篩選中與網域和 URI 相關的資訊；基於記錄的目的，將略過來自其他網域和 URI 的流量。
請注意，New-CsDiagnosticsFilter 指令程式會為診斷篩選建立僅存在記憶體內的執行個體。建立其中一個虛擬篩選之後，接著將需使用 New-CsDiagnosticConfiguration 或 Set-CsDiagnosticConfiguration，將該篩選新增至集合中。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsDiagnosticsFilter Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDiagnosticsFilter"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Enabled |
必要 |
布林值 |
指出是否應採用篩選。預設值為 True ($True)。 |
ExcludeConferenceMessages |
選用 |
布林值 |
如果設為 True，關於會議訊息的資訊 (也就是，任何在其 To 或 From 標頭中含有會議 URI 的訊息) 不會記錄於記錄檔中。預設值為 False。 |
ExcludePresenceNotifications |
選用 |
布林值 |
如果設為 True，關於目前狀態通知的資訊 (也就是，任何使用 NOTIFY 或 BENOTIFY 方法的訊息) 不會記錄於記錄檔中。預設值為 False。 |
ExcludeRegisterMessages |
選用 |
布林值 |
如果設為 True，關於用戶端註冊的資訊 (也就是，任何使用 REGISTER 方法的訊息) 不會記錄於記錄檔中。預設值為 False。 |
ExcludeSubscribeMessages |
選用 |
布林值 |
如果設為 True，關於用戶端訂閱的資訊 (也就是，任何使用 SUBSCRIBE 方法的訊息) 不會記錄於記錄檔中。預設值為 False。 |
Fqdn |
選用 |
PS 清單修改程式 |
要包含於篩選的網域集合 (更嚴格來說，這些網域是 SIP 位址的主機部分)。針對 FQDN 屬性，您可以使用完整網域名稱 (FQDN)，例如：fabrikam.com。或者，可使用萬用字元來代表多個網域：*.fabrikam.com。您可以在單一篩選上擁有一個以上的網域。 |
Uri |
選用 |
PS 清單修改程式 |
要包含於篩選中的 URI 集合 (URI 是 SIP 位址的 user@host 部分)。URI 可以由下列任何模式所組成： user@fabrikam.com user@* *@fabrikam.com 您可以在單一篩選中包含多個 URI。 |
輸入類型
無。New-CsDiagnosticsFilter 不會接受管線傳送的資料。
傳回類型
New-CsDiagnosticsFilter 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.Filter 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
範例 1 所示的命令使用 New-CsDiagnosticsFilter 來建立新的診斷篩選，然後將該篩選指派給通用診斷組態設定。為了執行此作業，第一個命令會呼叫 New-CsDiagnosticsFilter 來建立僅存在記憶體內的診斷篩選。此篩選會將 FQDN fabrikam.com 和 URI user@fabrikam.com 新增至篩選中。此命令也會將 Enabled 屬性設為 ($True) 以啟動篩選。所產生的虛擬篩選接著會儲存於變數 $x 中。
在第二個命令中，Set-CsDiagnosticConfiguration 可用來將新的篩選指派給通用診斷組態設定。在此案例中，任何存在於 Filter 屬性中的值都將由儲存於 $x 中的新建篩選所取代。
-------------------------- 範例 2 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com","contoso.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
範例 2 所示的命令是範例 1 顯示的命令變化；但在範例 2 中，會將兩個 FQDN (fabrikam.com 和 contoso.com) 新增至篩選的 Fqdn 屬性。為達成此目的，這兩個名稱 (由逗號分隔) 可用來做為 Fqdn 參數的參數值。