Remove-CsCdrConfiguration
Ultima modifica dell'argomento: 2012-03-26
Rimuove la raccolta specificata di impostazioni della registrazione dettagli chiamata. 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
Remove-CsCdrConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
La registrazione dettagli chiamata consente di tenere traccia dell'utilizzo di funzionalità di Microsoft Lync Server 2010 quali le chiamate VoIP (Voice over Internet Protocol), la messaggistica istantanea, i trasferimenti di file, le conferenze audio/video (A/V) e le sessioni di condivisione di 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, l'eventuale trasferimento di file e così via. Non viene invece registrata la chiamata stessa.
Con la registrazione dettagli chiamata, inoltre, viene tenuta traccia delle informazioni relative a errori delle chiamate: dati di diagnostica dettagliati sia per sessioni peer-to-peer che per le chiamate al servizio di conferenza.
In qualità di amministratore è possibile specificare se utilizzare la registrazione dettagli chiamata nell'organizzazione. Se è stato distribuito il servizio di monitoraggio, è possibile abilitare o disabilitare la registrazione dettagli chiamata senza difficoltà. È 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 di singolo sito, utilizzando ad esempio questa funzionalità nel sito Redmond, ma non nel sito Paris.
Le impostazioni specifiche per il sito create tramite New-CsCdrConfiguration possono essere rimosse successivamente utilizzando il cmdlet Remove-CsCdrConfiguration. Una volta rimosse le impostazioni specifiche per il sito, la registrazione dettagli chiamata relativa a tale sito verrà gestita automaticamente in base alle impostazioni di configurazione globali di tale funzionalità.
È inoltre possibile eseguire Remove-CsCdrConfiguration per le impostazioni globali della funzionalità registrazione dettagli chiamata. Poiché tuttavia le impostazioni globali non possono essere rimosse, verranno ripristinati i relativi valori predefiniti. Si supponga ad esempio di aver impostato su 90 il valore della proprietà KeepCallDetailForDays nelle impostazioni globali. Se si esegue Remove-CsCdrConfiguration per le impostazioni globali, verrà ripristinato il valore predefinito di tale proprietà, ovvero 60.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsCdrConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCdrConfiguration"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Obbligatorio |
Identità XDS |
Identificatore univoco delle impostazioni di configurazione di registrazione dettagli chiamata da rimuovere. Per "rimuovere" le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Come già evidenziato, le impostazioni globali non vengono effettivamente rimosse, bensì vengono ripristinati i valori predefiniti delle relative proprietà. Per rimuovere le impostazioni dall'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Non è possibile utilizzare caratteri jolly quando si specifica il parametro Identity. |
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. Remove-CsCdrConfiguration accetta l'input da pipeline di oggetti configurazione registrazione dettagli chiamata.
Tipi restituiti
Nessuno. Il cmdlet piuttosto elimina le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsCdrConfiguration -Identity site:Redmond
Nel comando precedente viene utilizzato Remove-CsCdrConfiguration per rimuovere le impostazioni di registrazione dettagli chiamata assegnate al sito Redmond. L'utilizzo del parametro Identity garantisce che vengano rimosse solo le impostazioni assegnate al sito specificato.
-------------------------- Esempio 2 --------------------------
Get-CsCdrConfiguration -Filter site:* | Remove-CsCdrConfiguration
Il comando riportato nell'esempio 2 rimuove tutte le impostazioni di registrazione dettagli chiamata assegnate all'ambito del sito. A tale scopo, nel comando vengono innanzitutto utilizzati Get-CsCdrConfiguration e il parametro Filter per recuperare le impostazioni di registrazione dettagli chiamata appropriate. Il valore stringa "site:*" assicura che vengano restituite solo le impostazioni con valore Identity che inizia con i caratteri "site:". La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsCdrConfiguration, che elimina tutti gli elementi della raccolta.
-------------------------- Esempio 3 --------------------------
Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30} | Remove-CsCdrConfiguration
Nell'esempio 3 vengono eliminate tutte le impostazioni di registrazione dettagli chiamata con proprietà KeepCallDetailForDays impostata su un valore inferiore a 30 giorni. Per eseguire questa attività, il comando chiama Get-CsCdrConfiguration senza ulteriori parametri per restituire una raccolta di tutte le impostazioni di registrazione dettagli chiamata attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni con proprietà KeepCallDetailForDays impostata su un valore inferiore a 30 giorni. La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsCdrConfiguration, che elimina ogni elemento presente nella raccolta.