Condividi tramite

  • Articolo

Set-CsCdrConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Modifica una raccolta esistente di impostazioni di registrazione dettagli chiamata. La registrazione dettagli chiamata consente di tenere traccia dell'utilizzo delle sessioni di messaggistica istantanea peer-to-peer, delle chiamate telefoniche VoIP (Voice over Internet Protocol) e delle conferenze telefoniche. Questi dati sull'utilizzo includono informazioni sui chiamanti, sugli utenti chiamati, sulla data della chiamata e sulla durata della conversazione.

Sintassi

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

Set-CsCdrConfiguration [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

La registrazione dettagli chiamata consente di tenere traccia dell'utilizzo delle funzionalità di Microsoft Lync Server 2010, quali chiamate telefoniche VoIP, messaggistica istantanea, trasferimento file, conferenze audio/video e sessioni di condivisione applicazioni. Con la registrazione dettagli chiamata (che è disponibile soltanto se è stato distribuito il servizio di monitoraggio) vengono registrate informazioni sull'utilizzo, quali le parti coinvolte nella chiamata, la durata della chiamata, se sono stati trasferiti file o meno e così via. Non viene, tuttavia, registrata la chiamata stessa.

Con la registrazione dettagli chiamata, inoltre, viene tenuta traccia delle informazioni relative a errori delle chiamate: i dati di diagnostica dettagliati per sessioni peer-to-peer e per conferenze telefoniche.

L'amministratore è in grado di stabilire se la registrazione dei dettagli della chiamata debba o meno essere utilizzata nell'organizzazione; una volta abilitato il servizio di monitoraggio, l'abilitazione o la disabilitazione della registrazione sono operazioni estremamente semplici. Inoltre, è possibile prendere questa decisione a livello globale (nel qual caso la registrazione dettagli chiamata verrà abilitata o disabilitata all'interno di tutta l'organizzazione) o sito per sito. Ad esempio, si potrebbe utilizzare la registrazione dettagli chiamata nel sito Redmond ma non nel sito Paris.

Gli amministratori possono inoltre gestire il database di registrazione dettagli chiamata, ad esempio per specificare il numero di giorni di conservazione dei record prima dell'eliminazione dal database. Le modifiche come queste possono essere apportate con il cmdlet Set-CsCdrConfiguration.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsCdrConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) 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 "Set-CsCdrConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco assegnato alla raccolta di impostazioni di configurazione di registrazione dettagli chiamata. Per fare riferimento alle impostazioni globali, utilizzare la sintassi seguente: -Identity global. Per fare riferimento a una raccolta configurata nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Non è possibile utilizzare caratteri jolly per specificare un'identità.

Se questo parametro viene omesso, Set-CsCdrConfiguration modifica le impostazioni globali.

Instance

Facoltativo

Oggetto CdrSettings

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

EnableCDR

Facoltativo

Booleano

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

EnablePurging

Facoltativo

Booleano

Indica se i record di registrazione dettagli chiamata saranno periodicamente eliminati dal database di registrazione dettagli chiamata. Se l'impostazione è True (il valore predefinito) i record verranno eliminati dopo il periodo specificato nelle proprietà KeepCallDetailForDays (per i record di registrazione dettagli chiamata) e KeepErrorReportForDays (per gli errori di registrazione dettagli chiamata). Se False, le registrazioni verranno mantenute indefinitamente.

KeepCallDetailForDays

Facoltativo

Numero intero

Indica il numero di giorni per i quali i record di registrazione dettagli chiamata verranno conservati nel database di registrazione dettagli chiamata; eventuali registrazioni precedenti il numero specificato di giorni verranno automaticamente eliminate. L'eliminazione avviene solo se la proprietà EnablePurging è stata impostata su True.

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

KeepErrorReportForDays

Facoltativo

Numero intero

Indica il numero di giorni per cui saranno conservati gli errori di registrazione dettagli chiamata; i report più vecchi rispetto al numero di giorni specificato saranno eliminati automaticamente. I report con gli errori di registrazione dettagli chiamata sono report diagnostici caricati dalle 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; 0 rappresenta la mezzanotte, 23 rappresenta le 11 di sera. È possibile specificare soltanto l'ora del giorno; è quindi possibile pianificare la cancellazione alle 4.00 del mattino, ma non alle 4.30 o alle 4.15. Il valore predefinito è 2 (2.00 del mattino). È 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 evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

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

Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings. Set-CsCdrConfiguration accetta l'input da pipeline di oggetti configurazione registrazione dettagli chiamata.

Tipi restituiti

Set-CsCdrConfiguration non restituisce alcun oggetto o valore. Il cmdlet, invece, consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CDRSettings.

Esempio

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

Set-CsCdrConfiguration -Identity site:Redmond -PurgeHourOfDay 23

Con l'esempio precedente viene impostata l'ora del giorno per l'eliminazione dei record obsoleti. In questo caso l'ora è impostata su 23 (le 11 di sera). Il parametro Identity è utilizzato per garantire che le modifiche siano apportate solamente alle impostazioni di registrazione dettagli chiamata con identità site:Redmond.

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

Get-CsCdrConfiguration | Set-CsCdrConfiguration -PurgeHourOfDay 23

L'esempio 2 è una variazione del comando mostrato nell'esempio 1. In questo caso viene modificata la proprietà PurgeHourOfDay per ogni raccolta di impostazioni di configurazione di registrazione dettagli chiamata attualmente in uso nell'organizzazione. Per ottenere tale risultato, il comando chiama per prima cosa Get-CsCdrConfiguration senza parametri per restituire una raccolta di tutte le impostazioni di registrazione dettagli chiamata attualmente in uso. La raccolta viene quindi inviata tramite pipe a Set-CsCdrConfiguration, che recupera ogni elemento nella raccolta e cambia il valore della proprietà PurgeHourOfDay in 23.

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

Get-CsCdrConfiguration -Filter "site:*"| Set-CsCdrConfiguration -PurgeHourOfDay 23

Nell'esempio 3 è mostrata un'altra variazione del comando dell'esempio 1. In questo caso, viene modificata la proprietà PurgeHourOfDay per tutte le impostazioni di configurazione di registrazione dettagli chiamata configurate nell'ambito del sito. Per eseguire questa operazione, il comando chiama per prima cosa Get-CsCdrConfiguration con il parametro Filter; il valore del filtro "site:*" garantisce la restituzione delle sole impostazioni di registrazione dettagli chiamata la cui identità inizia con il valore stringa "site:". La raccolta filtrata viene inviata tramite pipe a Set-CsCdrConfiguration, che modifica la proprietà PurgeHourOfDay per tutti gli elementi nella raccolta.