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