Remove-CsDiagnosticConfiguration
上次修改主題的時間： 2012-03-25
移除組織中目前正在使用的一或多個診斷組態設定集合。診斷組態設定可用來決定是否在您的 Microsoft Lync Server 2010 記錄檔中，記錄進出某個網域或統一資源識別項 (URI) 的流量。
語法
Remove-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
如果您啟用 Lync Server 2010 記錄功能，則這些記錄檔中預設會包含進出任何網域或 URI 的流量。這可確保記錄檔中會盡量記錄最多的資訊。
但是，這有時候會造成資訊過多。例如，當遇到特定網域的連線問題時，需要將記錄範圍限制在您網路與該網路間的流量；這樣您才能更容易識別相關記錄，進而更輕鬆地診斷並修正問題。
診斷組態設定可讓您指定要在記錄檔中記錄的網域或 URI；如果啟用診斷篩選功能，則只會記錄進出特定網域的流量。Lync Server 讓您能夠在站台範圍建立診斷組態設定，並套用診斷篩選器。如此一來，您將能對某個站台 (例如 Redmond) 套用篩選，同時又對其他站台停用篩選。
您可以使用 Remove-CsDiagnosticConfiguration 指令程式，來移除您在站台範圍所建立的任何診斷組態設定。您也可以對通用診斷組態集合執行 Remove-CsDiagnosticConfiguration 指令程式。不過，在該情況下，將不會刪除集合；因為 Lync Server 不允許您刪除通用集合。但是，移除通用集合會導致該集合中的屬性重設為其預設值。也就是說，將會移除新增至該集合的所有篩選。
誰可以執行這個指令程式：根據預設，會授權下列群組的成員執行 Remove-CsDiagnosticConfiguration Cmdlet：本機執行的指令程式：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDiagnosticConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
要移除之診斷組態設定的唯一識別碼。若要移除在此站台範圍設定的設定，請使用類似如下的語法：-Identity "site:Redmond"。 Remove-CsDiagnosticConfiguration 也可以針對通用組態設定來執行；在該情況下，請使用下列語法：–Identity global.不過，實際上不會移除通用設定；但通用設定中找到的屬性將會重設為其預設值。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 物件。Remove-CsDiagnosticConfiguration 接受診斷篩選器設定物件管線傳送的執行個體。
傳回類型
無。Remove-CsDiagnosticConfiguration 而是會刪除 Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsDiagnosticConfiguration -Identity site:Redmond
以上的命令會刪除 Identity 為 site:Redmond 的診斷組態設定。
-------------------------- 範例 2 ------------------------
Get-CsDiagnosticConfiguration -Filter site:* | Remove-CsDiagnosticConfiguration
範例 2 所示的命令會刪除已在網站範圍設定的所有診斷組態設定。若要這樣做，此命令會呼叫 Get-CsDiagnosticConfiguration 並搭配 Filter 參數；篩選值 "site:*" 會將傳回的資料限制為 Identity 開頭字元為 "site:" 的設定。然後，篩選過的集合會傳送到 Remove-CsDiagnosticConfiguration，這會移除該集合中的每一個項目。
-------------------------- 範例 3 ------------------------
Get-CsDiagnosticConfiguration | Remove-CsDiagnosticConfiguration
在範例 3 中，命令會刪除組織目前所使用的所有診斷組態設定。若要執行此工作，請先呼叫未含任何參數的 Get-CsDiagnosticConfiguration，以傳回目前用於組織之所有診斷組態設定的集合。這些項目接著會傳送到 Remove-CsDiagnosticConfiguration，其會移除集合中的每個項目。