Set-CsCdrConfiguration
上次修改主題的時間： 2012-03-26
修改現有的詳細通話記錄 (CDR) 設定集合。CDR 可讓您追蹤對等立即訊息工作階段、Voice over Internet Protocol (VoIP) 電話以及會議電話的使用情形。這項使用資料包括撥號方、收話方、通話時間及通話時間長度等資訊。
語法
Set-CsCdrConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
Set-CsCdrConfiguration [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
詳細描述
詳細通話記錄 (CDR) 讓您能夠追蹤 Microsoft Lync Server 2010 功能的使用狀況，這些功能包括 Voice over Internet Protocol (VoIP) 通話、立即訊息 (IM)、檔案傳輸、音訊/視訊 (A/V) 會議，以及應用程式分享工作階段。CDR (只有在您有部署監視服務時才能使用) 會保留使用狀況資訊：它會記錄通話方、通話長度、是否傳輸任何檔案等資訊 但是，CDR 不會記錄通話本身。
CDR 也會追蹤通話錯誤資訊：點對點工作階段與會議電話的詳細診斷資料。
做為系統管理員，您可以決定是否要在組織中使用 CDR；假設已部署監控服務，您就可以輕鬆地啟用或停用 CDR。此外，您還可以依全域 (在整個組織啟用或停用 CDR) 或個別站台的基礎來進行此決策。例如，您可以在 Redmond 站台使用 CDR，但在 Paris 站台不使用 CDR。
系統管理員也可以管理 CDR 資料庫；例如，您可以指定在從該資料庫中清除 CDR 記錄之前要保留該記錄的天數。諸如這類的變更可以使用 Set-CsCdrConfiguration 指令程式來進行。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsCdrConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCdrConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
指派給 CDR 組態設定集合的唯一識別碼。若要參照通用設定，請使用此語法：-Identity global。若要參考在此站台範圍設定的集合，請使用如下語法：-Identity site:Redmond。請注意，指定 Identity 時不能使用萬用字元。 如果省略此參數，則 Set-CsCdrConfiguration 會修改通用設定。 |
Instance |
選用 |
CdrSettings 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
EnableCDR |
選用 |
布林值 |
表示是否啟用 CDR。預設值為 True。 |
EnablePurging |
選用 |
布林值 |
表示是否要從 CDR 資料庫定期刪除 CDR 記錄。若為 True (預設值)，則會在過了 KeepCallDetailForDays (適用於 CDR 記錄) 和 KeepErrorReportForDays (適用於 CDR 錯誤) 內容指定的期間之後刪除記錄。若為 False，則會無限期保留 CDR 記錄。 |
KeepCallDetailForDays |
選用 |
整數 |
表示在 CDR 資料庫保留 CDR 記錄的天數；任何超過指定天數的記錄都將自動刪除。(請注意，只有在 EnablePurging 屬性已設為 True 時，才會進行清除)。 您可以將此屬性設為任何介於 1 與 2562 天 (大約 7 年) 的整數值。預設值為 60。 |
KeepErrorReportForDays |
選用 |
整數 |
表示保留 CDR 錯誤報告的天數；任何超過指定天數的報告都將自動刪除。CDR 錯誤報告是由 Microsoft Lync 2010 這類用戶端應用程式所上載的診斷報告。 您可以將此屬性設為任何介於 1 與 2562 天 (大約 7 年) 的整數值。預設值為 60。 |
PurgeHourOfDay |
選用 |
整數 |
表示從 CDR 資料庫刪除過期記錄的當地時間。時間是以 24 小時制指定，0 代表午夜 (12:00 A.M.)，而 23 則代表 11:00 P.M.。請注意，您只能指定每天中的小時；這表示，雖然您可以將清除作業排定在 4:00 A.M. 進行，但無法將清除作業排定在 4:30 A.M. 或 4:15 A.M. 進行。預設值為 2 (2:00 A.M.)。建議在下班時間進行清除作業。 只有在 EnablePurging 屬性設為 True 時，才會進行資料庫清除作業。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings。Set-CsCdrConfiguration 接受詳細通話記錄組態物件管線傳送的輸入。
傳回類型
Set-CsCdrConfiguration 不會傳回值或物件。反之，指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CDRSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsCdrConfiguration -Identity site:Redmond -PurgeHourOfDay 23
上述範例會設定清除舊記錄的時間。在此例中，該時間會設為 23 (24 小時制的 11:00 P.M.)。Identity 參數用來確保只會對具有 Identity site:Redmond 的 CDR 設定進行這些變更。
-------------------------- 範例 2 --------------------------
Get-CsCdrConfiguration | Set-CsCdrConfiguration -PurgeHourOfDay 23
範例 2 是範例 1 所示命令的變化；在此例中，會針對組織中目前使用的每個 CDR 組態設定集合，修改 PurgeHourOfDay 屬性。為達成此目的，此命令會先呼叫 Get-CsCdrConfiguration 且不搭配任何參數，以便傳回目前使用中的所有 CDR 設定的集合。然後，將此集合傳送至 Set-CsCdrConfiguration，由其取得集合中的每一個項目，並將 PurgeHourOfDay 屬性的值變更為 11:00 PM (23)。
-------------------------- 範例 3 --------------------------
Get-CsCdrConfiguration -Filter "site:*"| Set-CsCdrConfiguration -PurgeHourOfDay 23
範例 3 所示是範例 1 所用命令的另一個變化。在此範例中，會針對所有已在站台範圍設定的 CDR 設定，變更 PurgeHourOfDay 屬性。為了執行此作業，命令會先呼叫 Get-CsCdrConfiguration 搭配 Filter 參數；篩選值 "site:*" 確保只會有 Identity 是以字串值 "site:" 開頭的 CDR 設定開頭的設定。然後將篩選過的集合傳送到 Set-CsCdrConfiguration，其會變更該集合中每個項目的 PurgeHourOfDay 內容。