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 遭到刪除的同時隨即消失。