Set-CsDiagnosticConfiguration
上次修改主題的時間： 2012-03-26
修改現有的診斷組態設定。診斷組態設定可用來決定是否在您的 Microsoft Lync Server 2010 記錄檔中，記錄進出某個網域或統一資源識別項 (URI) 的流量。
語法
Set-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsDiagnosticConfiguration [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
詳細描述
如果您啟用 Lync Server 2010 記錄功能，則這些記錄檔中預設會包含進出任何網域或 URI 的流量。這可確保記錄檔中會盡量記錄最多的資訊。
但是，這有時候會造成資訊過多。例如，當遇到特定網域的連線問題時，需要將記錄範圍限制在您網路與該網路間的流量；這樣您才能更容易識別相關記錄，進而更輕鬆地診斷並修正問題。
診斷組態設定可讓您指定要記錄在記錄檔中的網域或 URI。Lync Server 可讓您在站台範圍內建立診斷組態設定。如此一來，您就可以將異於其他站台的設定套用至 Redmond 站台。
您可以使用 Set-CsDiagnosticConfiguration 指令程式，在指定集合中新增或移除篩選。篩選可用來指定要記錄流量的網域。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsDiagnosticConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDiagnosticConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要修改之診斷組態設定的唯一識別碼。若要修改在站台範圍設定的設定值，請使用如下的語法：-Identity "site:Redmond"。若要修改通用設定，請使用此語法：-Identity global。 如果未指定此參數，則 Set-CsDiagnosticConfiguration 將會自動修改通用設定。 |
Instance |
選用 |
DiagnosticFilterSettings 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
Filter |
選用 |
PS 清單修改程式 |
要記錄流量之網域和 URI 的集合。Filter 內容含有三個不同的項目，並且需要使用 New-CsDiagnosticsFilter 指令程式來加以建立： Fqdn – 要包含在篩選中之網域的集合 (更嚴格來說，是 SIP 位址的主機部分)。例如，完整網域名稱 (FQDN ) 可能類似如下：fabrikam.com。或者，可使用萬用字元來代表多個網域：*.fabrikam.com。您可以在單一篩選中包含多個網域。 Uri – 要包含在篩選中之 URI 的集合。(Uri 代表 SIP 位址中的 user@host 部分)。URI 可以由下列任何模式所組成：user@fabrikam.com、user@* 或 *@fabrikam.com。您可以在單一篩選中包括多個 URI。 Enabled – 表示是否要啟用篩選。 |
LoggingShare |
選用 |
字串 |
上傳診斷記錄的共用資料夾。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 物件。Set-CsDiagnosticConfiguration 接受診斷組態設定物件管線傳送的執行個體。
傳回類型
Set-CsDiagnosticConfiguration 不會傳回值或物件。反之，指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri sip:user@fabrikam.com
Set-CsDiagnosticConfiguration -Identity global -Filter $x
範例 1 所示的命令使用 New-CsDiagnosticsFilter 建立新的診斷篩選，然後將該篩選指派給通用診斷組態設定。若要執行此工作，第一個命令會呼叫 New-CsDiagnosticsFilter 建立只存在於記憶體中的診斷篩選，此篩選會使用 FQDN fabrikam.com 和 URI sip:user@fabrikam.com。然後再將「虛擬」篩選儲存在變數 $x 中。
在命令 2 中，Set-CsDiagnosticConfiguration 會將新的篩選指派給通用診斷組態設定。在此狀況下，任何存在於 Filter 屬性中的值都會取代為新建立的篩選。
-------------------------- 範例 2 ------------------------
$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Add("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x
範例 2 會示範如何將新的 FQDN 新增至通用診斷組態設定的 Filter 屬性。若要執行這項操作，範例中的第一個命令會使用 Get-CsDiagnosticConfiguration 擷取通用設定的 Filter 屬性值。這可藉由將 Get-CsDiagnosticConfiguration 的呼叫放置在括弧中來達成，如此會使 Windows PowerShell 在執行其他任何工作之前，先執行該命令。傳回通用設定之後，會擷取 Filter 屬性的值並儲存在名為 $x 的變數中。
在第二個命令中，Add 方法用於將新的 FQDN (fabrikam.com) 新增至篩選。當此工作完成時，範例中的最後一個命令會使用 Set-CsDiagnosticConfiguration 寫入修改後的診斷集合。最終結果是，fabrikam.com 將會新增至已包含在 Filter 屬性中的任何 FQDN。
-------------------------- 範例 3 ------------------------
$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Remove("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x
範例 3 所示的命令會從 Filter 屬性通用診斷組態設定中移除 FQDN (fabrikam.com)。範例中的第一個命令會使用 Get-CsDiagnosticConfiguration 擷取通用設定之 Filter 屬性的目前值；此值會儲存在名為 $x 的變數中。在擷取該值之後，會使用 Remove 方法移除 FQDN fabrikam.com。在移除 FQDN 之後，會使用 Set-CsDiagnosticConfiguration 將修改過的篩選 (儲存在變數 $x 中) 寫入通用設定。
-------------------------- 範例 4 ------------------------
Set-CsDiagnosticConfiguration -Identity global -Filter $Null
在範例 4 中，通用診斷組態設定之 Filter 內容中的所有項目都會遭到移除。這可以透過將 Filter 屬性設為 Null 值來完成。