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.
Vedere anche
Ulteriori risorse
Get-CsCdrConfiguration
Remove-CsCdrConfiguration
Set-CsCdrConfiguration