Condividi tramite

  • Articolo

New-CsCdrConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Crea un nuovo insieme di impostazioni per la registrazione dettagli chiamata (CDR, Call Detail Recording). Tale funzionalità consente di tenere traccia dell'utilizzo di elementi quali le sessioni di messaggistica istantanea peer-to-peer, le chiamate telefoniche VoIP (Voice over Internet Protocol) e le chiamate al servizio di conferenza. Questi dati relativi all'utilizzo includono informazioni sull'utente chiamante e sull'utente chiamato, sulla data della chiamata e sulla durata della conversazione.

Sintassi

New-CsCdrConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

La registrazione dettagli chiamata consente di tenere traccia dell'utilizzo di funzionalità di Microsoft Lync Server 2010 quali chiamate VoIP, messaggistica istantanea, trasferimenti di file, conferenze audio/video e sessioni di condivisione delle applicazioni. Con la registrazione dettagli chiamata, disponibile soltanto se è stato distribuito il servizio di monitoraggio, vengono registrate informazioni sull'utilizzo, tra cui le parti coinvolte nella chiamata, la durata della stessa e l'eventuale trasferimento di file. Non viene invece effettuata una registrazione della chiamata vera e propria.

Con la registrazione dettagli chiamata, inoltre, viene tenuta traccia delle informazioni relative a errori delle chiamate: i dati di diagnostica dettagliati sia per le sessioni peer-to-peer che per le chiamate al servizio di conferenza.

L'amministratore può decidere se utilizzare o meno la registrazione dettagli chiamata nell'organizzazione. Se il servizio di monitoraggio è stato distribuito, l'abilitazione o la disabilitazione di tale funzionalità è un'operazione estremamente semplice. È inoltre possibile applicare questa scelta globalmente (nel qual caso la funzionalità di registrazione dettagli chiamata verrà abilitata o disabilitata nell'intera organizzazione) o a livello del singolo sito (ad esempio, è possibile decidere di utilizzare la funzionalità nel sito Redmond, ma non nel sito Paris).

Il cmdlet New-CsCdrConfiguration consente di creare nuove raccolte di impostazioni per la registrazione dettagli chiamata nell'ambito del sito. (Le nuove impostazioni non possono essere create nell'ambito globale.) Ciascun sito può ospitare solo una singola raccolta di tali impostazioni. Ciò significa che non è possibile creare una nuova raccolta per il sito Redmond se il sito dispone già di un set di impostazioni di configurazione per registrazione dettagli chiamata. Se si tenta di eseguire questa operazione, il comando avrà esito negativo.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsCdrConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Rappresenta l'identificatore univoco da assegnare alla nuova raccolta delle impostazioni di configurazione per registrazione dettagli chiamata. Poiché è possibile creare nuove raccolte solo nell'ambito del sito, il valore Identity avrà sempre il prefisso "site:" seguito dal nome del sito, come, ad esempio, "site:Redmond".

EnableCDR

Facoltativo

Booleano

Indica se la registrazione dettagli chiamata è abilitata o meno. Il valore predefinito è True.

EnablePurging

Facoltativo

Booleano

Indica se le registrazioni dettagli chiamata saranno eliminate periodicamente dal relativo database. Se il parametro è impostato su True (valore predefinito), i dati verranno eliminati dopo il periodo di tempo specificato nelle proprietà KeepCallDetailForDays (registrazioni dettagli chiamata) e KeepErrorReportForDays (errori di registrazione dettagli chiamata). Se False, le registrazioni verranno mantenute indefinitamente.

KeepCallDetailForDays

Facoltativo

Numero intero

Indica per quanti giorni le registrazioni dettagli chiamata verranno conservate nel relativo database. Le eventuali registrazioni antecedenti al numero di giorni specificato verranno eliminate automaticamente. (Si noti che la cancellazione avverrà soltanto se la proprietà EnablePurging è stata impostata su True.)

KeepCallDetailForDays può essere impostato su qualsiasi valore intero compreso tra 1 e 2562 giorni (circa 7 anni). Il valore predefinito è 60.

KeepErrorReportForDays

Facoltativo

Numero intero

Indica per quanti giorni i report sugli errori di registrazione dettagli chiamata verranno conservati. Gli eventuali report antecedenti al numero di giorni specificato verranno eliminati automaticamente. I report con gli errori di registrazione dettagli chiamata sono report diagnostici caricati da applicazioni client come Microsoft Lync 2010.

È possibile impostare questa proprietà su qualsiasi valore intero compreso tra 1 e 2562 giorni (circa 7 anni). Il valore predefinito è 60.

PurgeHourOfDay

Facoltativo

Numero intero

Indica l'ora del giorno locale per l'eliminazione dei record scaduti dal database di registrazione dettagli chiamata. L'ora del giorno viene specificata nel formato 24 ore, con lo 0 che corrisponde alla mezzanotte (00.00) e il 23 che corrisponde alle 23.00. Si noti che è possibile indicare solo l'ora del giorno. È pertanto possibile pianificare l'esecuzione della cancellazione per le 04.00, ma non per le 04.30 o le 04.15. Il valore predefinito è 2, che corrisponde alle 02.00. È consigliabile che la cancellazione avvenga in orari di non utilizzo.

La cancellazione del database si verifica solo se la proprietà EnablePurging è impostata su True.

Force

Facoltativo

Parametro opzionale

Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno. New-CsCdrConfiguration non accetta l'input da pipeline.

Tipi restituiti

Crea istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings.

Esempio

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

New-CsCdrConfiguration -Identity site:Redmond -EnableCDR $False

Nel comando dell'esempio 1 viene utilizzato il cmdlet New-CsCdrConfiguration per creare un nuovo insieme di impostazioni per la registrazione dettagli chiamata con valore Identity site:Redmond. Oltre al valore Identity site:Redmond, le nuove impostazioni presentano anche la proprietà EnableCDR impostata su False. Poiché le impostazioni del sito hanno la precedenza sulle impostazioni globali, la registrazione dettagli chiamata non verrà utilizzata nel sito Redmond, indipendentemente dal fatto che tale funzionalità sia stata o meno abilitata nell'ambito globale.

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

$x = New-CsCdrConfiguration -Identity site:Redmond -InMemory
$x.EnableCDR = $False
Set-CsCdrConfiguration -Instance $x

Nell'esempio 2 viene utilizzato il parametro InMemory per mostrare come è possibile creare una nuova raccolta di impostazioni di configurazione per la registrazione dettagli chiamata che inizialmente esistano soltanto in memoria. A tale scopo, nell'esempio vengono innanzitutto utilizzati New-CsCdrConfiguration e il parametro InMemory per creare una raccolta virtuale di impostazioni con valore Identity site:Redmond. La raccolta virtuale viene archiviata nella variabile $x. Se la raccolta non fosse archiviata in una variabile, verrebbe creata e quindi scomparirebbe immediatamente.

Una volta creata la raccolta virtuale, con il comando mostrato nella riga 2 viene impostato il valore della proprietà EnableCDR su False ($False). Nella riga 3 viene quindi utilizzato Set-CsCdrConfiguration per trasformare la raccolta virtuale $x in una raccolta effettiva di impostazioni di configurazione per la registrazione dettagli chiamata, la quale viene applicata al sito Redmond. Se Set-CsCdrConfiguration non venisse chiamato, la raccolta virtuale scomparirebbe non appena termina la sessione di Windows PowerShell o non appena viene eliminata la variabile $x.