Condividi tramite

  • Articolo

Get-CsCdrConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulle impostazioni della registrazione dei dettagli della chiamata (CDR). La registrazione dei dettagli della chiamata (CDR) consente di tenere traccia delle sessioni di messaggistica istantanea peer-to-peer, delle chiamate VoIP e delle chiamate ai servizi di conferenza.

Sintassi

Get-CsCdrConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsCdrConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

La registrazione dei dettagli della chiamata consente di monitorare l'utilizzo delle funzionalità di Microsoft Lync Server 2010, quali telefonate VoIP, messaggi istantanei, trasferimento di file, conferenze audio/video e sessioni di condivisione delle applicazioni. La registrazione CDR (disponibile solo se è stato distribuito il servizio di monitoraggio) conserva le informazioni sull'utilizzo e registra informazioni quali le parti coinvolte nella conversazione, la sua durata, se si sono verificati o meno trasferimenti di file e così via. La registrazione dei dettagli della chiamata non registra però la chiamata.

La registrazione dei dettagli della chiamata tiene traccia anche delle informazioni su eventuali errori verificatesi durante la chiamata: dati di diagnostica dettagliati per le sessioni peer-to-peer e per le chiamate ai servizi di conferenza.

La scelta se utilizzare o meno la funzionalità di registrazione dei dettagli della chiamata nell'organizzazione dipende dall'amministratore. Se è stato distribuito il servizio di monitoraggio, è possibile abilitare o disabilitare la funzionalità CDR. Inoltre, è possibile applicare questa scelta globalmente (nel qual caso, la funzionalità CDR verrà abilitata o disabilitata nell'intera organizzazione) o a livello di singolo sito (ad esempio, si potrebbe voler utilizzare la funzionalità CDR nel sito Redmond, ma non nel sito Paris).

Il cmdlet Get-CsCdrConfiguration consente di ottenere informazioni dettagliate sulla modalità di utilizzo della registrazione dei dettagli della chiamata nell'organizzazione.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsCdrConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Indica l'identificatore univoco della raccolta di impostazioni di configurazione CDR che si desidera ottenere. Per ottenere le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per ottenere una raccolta configurata nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Si noti che non è consentito utilizzare i caratteri jolly per specificare l'identità. Se si desidera utilizzare i caratteri jolly, è necessario utilizzare il parametro Filter.

Se questo parametro non viene specificato, il cmdlet Get-CsCdrConfiguration restituirà una raccolta di tutte le impostazioni di configurazione CDR attualmente utilizzate nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per ottenere una raccolta di impostazioni di configurazione CDR. Ad esempio, per ottenere una raccolta di tutte le impostazioni configurate nell'ambito del sito, utilizzare la seguente sintassi: -Filter site:*. Per ottenere una raccolta di tutte le impostazioni in cui la stringa "Western" compare nell'identità, utilizzare la seguente sintassi: -Filter *Western*.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati di configurazione CDR dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsCdrConfiguration non accetta input tramite pipeline.

Tipi restituiti

Get-CsCdrConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings.

Esempio

-------------------------- Esempio 1 --------------------------

Get-CsCdrConfiguration

In questo esempio viene utilizzato il cmdlet Get-CsCdrConfiguration per ottenere una raccolta di tutte le impostazioni CDR configurate per l'utilizzo nella propria organizzazione.

-------------------------- Esempio 2 --------------------------

Get-CsCdrConfiguration -Identity site:Redmond

Nell'Esempio 2 viene utilizzato il parametro Identity per ottenere un'unica raccolta di impostazioni CDR: le impostazioni con Identity site:Redmond.

-------------------------- Esempio 3 --------------------------

Get-CsCdrConfiguration -Filter site:*

Nell'Esempio 3 viene utilizzato il parametro Filter per ottenere tutte le impostazioni CDR configurate nell'ambito del sito. Il valore del filtro "site:*" restituisce tutte le impostazioni CDR la cui identità inizia con la stringa "site:". Per definizione, queste impostazioni sono state configurate nell'ambito del sito.

-------------------------- Esempio 4 --------------------------

Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30}

Nell'esempio precedente si ottiene una raccolta di tutte le impostazioni CDR in cui la proprietà KeepCallDetailForDays è inferiore a 30 giorni. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsCdrConfiguration per ottenere una raccolta di tutte le impostazioni CDR configurate nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle impostazioni in cui la proprietà KeepCallDetailForDays è minore di 30 giorni.