New-CsDiagnosticConfiguration
上次修改主題的時間： 2012-03-23
建立新的診斷組態設定。診斷組態設定可用來決定是否在您的 Microsoft Lync Server 2010 記錄檔中，記錄進出某個網域或統一資源識別項 (URI) 的流量。
語法
New-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
如果您啟用 Lync Server 2010 記錄功能，則這些記錄檔中預設會包含進出任何網域或 URI 的流量。這可確保記錄檔中會盡量記錄最多的資訊。
但是，這有時候會造成資訊過多。例如，當遇到特定網域的連線問題時，需要將記錄範圍限制在您網路與該網路間的流量；這樣您才能更容易識別相關記錄，進而更輕鬆地診斷並修正問題。
診斷組態設定可讓您指定要在記錄檔中記錄的網域或 URI；例如，您可以只記錄進出特定網域的流量。Lync Server 可讓您在站台範圍內建立診斷組態設定。如此一來，您將能對某個站台 (例如 Redmond 站台) 套用與其他站台不同的設定。
請注意，您無法在全域範圍建立診斷組態設定；那是因為全域範圍已經主控這些設定。同樣地，如果指定的站台已經包含診斷組態設定，您就無法在站台範圍建立新設定集合。例如，如果您嘗試建立 Redmond 站台的新集合，而且該站台已經主控診斷組態設定，則您的命令將會失敗。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsDiagnosticConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDiagnosticConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
要建立之診斷組態設定的唯一識別碼。由於只能在站台範圍建立新設定，因此您必須使用如下的語法：-Identity "site:Redmond"。 |
Filter |
選用 |
PS 清單修改程式 |
如果啟用診斷篩選，將記錄其流量之網域和 URI 的集合。Filter 屬性由三種不同的項目組成： Fqdn – 要包含在篩選中之網域的集合 (更嚴格來說，這是 SIP 位址的主機部分)。例如，完整網域名稱 (FQDN) 可能看起來如下：fabrikam.com。或者，可使用萬用字元來代表多個網域：*.fabrikam.com。您可以在單一篩選中包含多個網域。 Uri – 要包含在篩選中之 URI 的集合。(Uri 是 SIP 位址的 user@host 部分)。URI 可以由下列任何模式所組成：user@fabrikam.com、user@* 或 *@fabrikam.com。您可以在單一篩選中包括多個 URI。 Enabled – 表示是否要啟用篩選。 |
LoggingShare |
選用 |
字串 |
上傳診斷記錄的共用資料夾。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsDiagnosticConfiguration 不會接受管線傳送的輸入。
傳回類型
New-CsDiagnosticConfiguration 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 的新執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsDiagnosticConfiguration -Identity site:Redmond
以上的命令會針對 Redmond 站台，建立新的診斷組態設定集合。
-------------------------- 範例 2 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri "sip:user@fabrikam.com" -Enabled $False
New-CsDiagnosticConfiguration -Identity site:Redmond -Filter $x
範例 2 所示的命令會建立新的診斷篩選，然後將該篩選指派給新的診斷設定集合。為了執行這項工作，第一個命令會呼叫 New-CsDiagnosticsFilter 來建立僅在於記憶體中的診斷篩選；此命令會將 FQDN fabrikam.com 和 URI sip:user@fabrikam.com 新增至篩選。此命令也會將 Enabled 屬性設為 ($True) 以啟動篩選。所產生的虛擬篩選接著會儲存於變數 $x 中。
在命令 2 中，使用了 New-CsDiagnosticConfiguration 為 Redmond 站台建立新的診斷組態設定集合。這些新設定將會使用變數 $x 中儲存的診斷篩選。
-------------------------- 範例 3 ------------------------
$x = New-CsDiagnosticConfiguration -Identity site:Redmond -InMemory
$x.LoggingShare = "\\atl-fs-001\logs"
Set-CsDiagnosticConfiguration -Instance $x
範例 3 所示的命令會示範如何建立一開始只存在於記憶體中的診斷組態設定。若要這樣做，第一個命令會呼叫 New-CsDiagnosticConfiguration 並搭配以下兩個參數：Identity (指定設定的 Identity) 和 InMemory，該參數指出新設定只能建立在記憶體中產生的物件儲存在變數 $x 中。
建立這些虛擬設定後，第二個命令可用來將 LoggingShare 內容設定為 UNC 路徑 \\atl-fs-001\logs。然後，會使用最後一個的命令，將虛擬診斷組態設定轉換為套用至 Redmond 站台的實際設定組合。請注意，最後一個命令是必要項目。如果您沒有呼叫 Set-CsDiagnosticConfiguration，則不會將設定套用至 Redmond 站台，而且只要您結束 Windows PowerShell 工作階段或刪除變數 $x，虛擬設定就會消失。