New-CsCdrConfiguration

構文

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 の機能 (ボイス オーバー IP (VoIP) 電話での通話、インスタント メッセージ (IM)、ファイル転送、音声またはビデオ (A/V) 会議、アプリケーション共有セッションなど) の使用状況を追跡できます。CDR (監視サービスを展開している場合のみ利用できます) は使用状況の追跡情報を保持し、通話の関係者、通話の長さ、ファイル転送の有無などの情報を記録します (ただし、CDR では通話内容そのものは記録されません)。

また、CDR は通話エラーの情報の追跡も行い、ピアツーピア セッションと電話会議の通話の両方の詳細な診断データを追跡します。

管理者として、組織で CDR を使用するかどうかを決定できます。監視サービスが展開されていれば、容易に CDR を有効または無効にできます。さらに、この決定をグローバル (その場合、CDR は組織全体で有効または無効のいずれかになります) またはサイトごとに行うことができます。たとえば、CDR を Redmond サイトでは使用可能にして、Paris サイトでは CDR を使用不可能にすることができます。

New-CsCdrConfiguration コマンドレットを使用して、サイト スコープで新しい CDR 設定コレクションを作成できます (グローバル スコープで新しい設定を作成することはできません)。各サイトがホストできるのは 1 つの CDR 設定コレクションだけであることに注意してください。つまり、Redmond サイトに既に CDR 構成設定がある場合、このサイトに新しいコレクションを作成することはできません。作成しようとすると、コマンドは失敗します。

このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーは New-CsCdrConfiguration コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsCdrConfiguration"}

パラメーター

入力の種類

なし。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 が削除されたときにすぐ消滅します。

関連項目

その他のリソース

Get-CsCdrConfiguration
Remove-CsCdrConfiguration
Set-CsCdrConfiguration