Remove-CsCdrConfiguration
上次修改主題的時間： 2012-03-26
移除指定的詳細通話記錄 (CDR) 設定集合。CDR 可讓您追蹤對等立即訊息工作階段、Voice over Internet Protocol (VoIP) 電話以及會議電話的使用情形。這項使用資料包括撥號方、收話方、通話時間及通話時間長度等資訊。
語法
Remove-CsCdrConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
詳細通話記錄 (CDR) 讓您能夠追蹤 Microsoft Lync Server 2010 功能的使用狀況，這些功能包括 Voice over Internet Protocol (VoIP) 通話、立即訊息、檔案傳輸、音訊/視訊 (A/V) 會議，以及應用程式分享工作階段。CDR (只有在您有部署監視服務時才能使用) 會保留使用狀況資訊：CDR 會記錄通話方、通話長度、是否傳輸任何檔案等資訊 (但 CDR 不會記錄通話本身)。
CDR 也會追蹤通話錯誤資訊：點對點工作階段與會議電話的詳細診斷資料。
做為系統管理員，您可以決定是否要在組織中使用 CDR。如果已部署監視服務，您便可以很輕鬆的啟用或停用 CDR。此外，您還可以依全域 (在整個組織啟用或停用 CDR) 或個別站台的基礎來進行此決策；例如，您可以在 Redmond 站台使用 CDR，但在 Paris 站台不使用 CDR。
使用 Remove-CsCdrConfiguration 指令程式可於稍後移除以 New-CsCdrConfiguration 建立的站台專屬設定。當您移除站台特定的設定時，受到這個動作影響之站台的 CDR 會自動由通用 CDR 組態設定管理。
您也可以針對通用 CDR 設定執行 Remove-CsCdrConfiguration。然而，由於通用設定無法移除，因此這些設定將重設為預設值。例如，假設您將通用設定中的 KeepCallDetailForDays 內容值設為 90。如果您針對通用設定執行 Remove-CsCdrConfiguration，則該內容將重設回預設值 60。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsCdrConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCdrConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
要移除的 CDR 組態設定的唯一識別碼。若要「移除」通用設定，請使用此語法：-Identity global。(請再次注意，您無法真正移除通用設定，您所能做的只有將屬性重設回預設值)。若要將設定從站台範圍移除，請使用如下語法：-Identity site:Redmond。您無法在指定 Identity 時使用萬用字元。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings. Remove-CsCdrConfiguration 接受 CDR 組態物件管線傳送的輸入。
傳回類型
無。而是指令程式會刪除 Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Remove-CsCdrConfiguration -Identity site:Redmond
以上的命令會使用 Remove-CsCdrConfiguration 移除指派給 Redmond 站台的 CDR 設定。使用 Identity 參數可確保只移除指派給指定站台的設定。
-------------------------- 範例 2 --------------------------
Get-CsCdrConfiguration -Filter site:* | Remove-CsCdrConfiguration
範例 2 所示命令會移除已在站台範圍指派的所有 CDR 設定。為了執行這項作業，命令會先使用 Get-CsCdrConfiguration 與 Filter 參數來擷取適當的 CDR 設定；字串值 "site:*" 可確定只有 Identity 開頭為字元 "site:" 的設定會才會傳回。然後將篩選過的集合傳送到 Remove-CsCdrConfiguration，這樣會刪除集合中的所有項目。
-------------------------- 範例 3 --------------------------
Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30} | Remove-CsCdrConfiguration
範例 3 中會刪除任何 KeepCallDetailForDays 屬性小於 30 天的 CDR 設定。為了完成此工作，命令會呼叫不含任何參數的 Get-CsCdrConfiguration，以傳回組織中目前使用的所有 CDR 設定集合。此集合便會傳送到 Where-Object 指令程式，這樣只會挑選出 KeepCallDetailForDays 屬性小於 30 天的設定。接著將篩選過的集合傳送到 Remove-CsCdrConfiguration，這樣會刪除集合中的每一個項目。