Get-CsCdrConfiguration
上次修改主題的時間： 2012-03-23
傳回關於您詳細通話記錄 (CDR) 設定的資訊。CDR 可讓您追蹤對等立即訊息工作階段、Voice over Internet Protocol (VoIP) 電話以及會議電話的使用情形。
語法
Get-CsCdrConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsCdrConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
詳細通話記錄 (CDR) 讓您能夠追蹤 Microsoft Lync Server 2010 功能的使用狀況，這些功能包括 Voice over IP (VoIP) 通話、立即訊息、檔案傳輸、音訊/視訊 (A/V) 會議，以及應用程式分享工作階段。CDR (只有在您部署了監控服務後才可使用) 會保留使用資訊：它會記錄通話方、通話長度、是否傳輸任何檔案等資訊 (但 CDR 不會記錄通話本身)。
CDR 也會追蹤通話錯誤資訊：點對點工作階段與會議電話的詳細診斷資料。
做為系統管理員，您可以決定是否要在組織中使用 CDR。假設已部署監控服務，就可以啟用或停用 CDR。此外，您還可以依全域 (在整個組織啟用或停用 CDR) 或個別網站的基礎來進行此決策；例如，您可以在 Redmond 網站使用 CDR，但在 Paris 網站不使用 CDR。
Get-CsCdrConfiguration 指令程式提供一種方式，讓您傳回關於 CDR 在組織中的使用方式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsCdrConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsCdrConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
表示您要傳回之 CDR 組態設定集合的唯一識別碼。若要參考通用設定，請使用此語法：-Identity global。若要參考在網站範圍設定的集合，請使用類似如下的語法：-Identity site:Redmond。請注意，指定 Identity 時，無法使用萬用字元。如果您需要使用萬用字元，請改用 Filter 參數。 如果未指定此參數，則 Get-CsCdrConfiguration 會傳回組織中目前使用之所有 CDR 組態設定的集合。 |
Filter |
選用 |
字串 |
可讓您使用萬用字元，以傳回 CDR 組態設定的集合。例如，若要傳回在此站台範圍所設定之所有設定集合，請使用此語法：-Filter site:*。若要傳回在 Identity 中任何位置出現字串值 "Western" 的所有設定集合，請使用以下語法：-Filter *Western*。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取 CDR 組態資料，而非從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsCdrConfiguration 不接受管線傳送的輸入。
傳回類型
Get-CsCdrConfiguration 傳回 Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsCdrConfiguration
此範例會使用 Get-CsCdrConfiguration 傳回設定為在組織中使用之所有 CDR 設定的集合。
-------------------------- 範例 2 --------------------------
Get-CsCdrConfiguration -Identity site:Redmond
範例 2 會使用 Identity 參數，傳回單一 CDR 設定集合：Identity 為 site:Redmond 的設定。
-------------------------- 範例 3 --------------------------
Get-CsCdrConfiguration -Filter site:*
在範例 3 中，會採用 Filter 參數來傳回在站台範圍設定的所有 CDR 設定。篩選值 "site:*" 會傳回 Identity 開頭為字串值 "site:" 的所有 CDR 設定。根據定義，這些是已在網站範圍設定的設定。
-------------------------- 範例 4 --------------------------
Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30}
以上的範例會傳回 KeepCallDetailForDays 屬性少於 30 天的所有 CDR 設定集合。若要這樣做，此命令會先使用 Get-CsCdrConfiguration 傳回組織中設定的所有 CDR 設定集合。此集合便會傳送到 Where-Object 指令程式，這樣只會挑選出 KeepCallDetailForDays 屬性小於 30 天的設定。