Condividi tramite

  • Articolo

New-CsArchivingConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Consente di creare un nuovo gruppo di impostazioni di archiviazione per la messaggistica istantanea. È possibile utilizzare queste impostazioni per abilitare o disabilitare il salvataggio automatico delle sessioni di messaggistica istantanea; queste impostazioni consentono anche di abilitare il blocco dei messaggi istantanei che non possono essere archiviati.

Sintassi

New-CsArchivingConfiguration -Identity <XdsIdentity> [-ArchiveDuplicateMessages <$true | $false>] [-BlockOnArchiveFailure <$true | $false>] [-CachePurgingInterval <UInt32>] [-Confirm [<SwitchParameter>]] [-EnableArchiving <None | ImOnly | ImAndWebConf>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-KeepArchivingDataForDays <UInt32>] [-PurgeExportedArchivesOnly <$true | $false>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Molte organizzazione ritengono utile conservare una trascrizione di tutte le sessioni di messaggistica istantanea effettuate dai loro utenti. Per altre organizzazioni, è obbligatorio conservare tali trascrizioni; ad esempio, molte organizzazioni del settore finanziario sono obbligate per legge a conservare copia di tutte le loro comunicazioni elettroniche.

Microsoft Lync Server 2010 garantisce la massima flessibilità nell'archiviazione dei messaggi istantanei e dei contenuti delle conferenze via Web. Se è stato distribuito Server di archiviazione, è possibile utilizzare i vari cmdlet CsArchivingConfiguration per abilitare e disabilitare l'archiviazione dei messaggi istantanei e per gestire il database di archiviazione. Se l'archiviazione non dovesse riuscire, è inoltre possibile sospendere la messaggistica istantanea. Questo consente di conservare un record di tutte le comunicazioni elettroniche.

Quando si installa Lync Server 2010, viene creata una raccolta di impostazioni di archiviazione globale; queste impostazioni verranno automaticamente applicate all'intera organizzazione. In alternativa, è possibile utilizzare il cmdlet New-CsArchivingConfiguration per creare impostazioni di configurazione personalizzate sito per sito.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsArchivingConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: 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 "New-CsArchivingConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco da assegnare alla nuova raccolta di impostazioni di archiviazione. Poiché è possibile creare nuove raccolte solo nell'ambito del sito, l'identità avrà sempre il prefisso "site:" seguito dal nome del sito; ad esempio "site:Redmond".

ArchiveDuplicateMessages

Facoltativo

Booleano

Consente di specificare il metodo di archiviazione dei messaggi istantanei scambiati tra pool diversi. Ad esempio, Davide Garghentini (con un account in Pool 1) invia un messaggio istantaneo a Luisa Cazzaniga (che ha un account in Pool 2). Pilar, a sua volta, invia una risposta al messaggio istantaneo di Ken. Se ArchiveDuplicateMessages è impostato su False, la trascrizione della sessione (in base a un algoritmo predefinito) viene registrata nel Pool 1 o nel Pool 2, ma non in entrambi. Se ArchiveDuplicateMessages è impostato su True (il valore predefinito), la trascrizione verrà registrata in entrambi i pool.

BlockOnArchiveFailure

Facoltativo

Booleano

Se impostato su True, il servizio di messaggistica istantanea verrà sospeso ogni volta che le sessioni di messaggistica istantanea non possono essere archiviate. Se impostato su False (il valore predefinito), la messaggistica istantanea continuerà anche se le sessioni non possono essere archiviate.

CachePurgingInterval

Facoltativo

Numero intero

Indica la frequenza (in ore) con la quale le trascrizioni vengono cancellate dal sistema, nei casi in cui nessuno dei partecipanti è stato abilitato per l'archiviazione. Per impostazione predefinita, tutte le sessioni di messaggistica istantanea di gruppo e le sessioni di conferenza vengono registrate nel momento in cui hanno luogo. All'intervallo di tempo specificato, il sistema stabilisce se qualcuno dei partecipanti a queste sessioni è stato abilitato per l'archiviazione. Se il sistema rileva una sessione nella quale nessuno dei partecipanti è stato abilitato per l'archiviazione, la relativa trascrizione viene cancellata dall'archivio.

La proprietà CachePurgeInterval può essere impostata su qualsiasi numero intero compreso tra 4 e 168, inclusi. Il valore predefinito è 24.

EnableArchiving

Facoltativo

Stringa

Indica quali elementi (qualora ve ne siano) devono essere salvati nell'archivio. I valori validi sono:

None. Nessun elemento viene salvato nell'archivio. Questo è il valore predefinito.

ImOnly. Le sessioni di messaggistica istantanea vengono salvate nell'archivio.

ImAndWebConf. Vengono archiviate sia le sessioni di messaggistica istantanea sia le sessioni di conferenza.

EnablePurging

Facoltativo

Booleano

Se impostato su True, i messaggi istantanei archiviati verranno periodicamente rimossi dall'archivio, a condizione che essi: 1) siano precedenti al valore specificato nella proprietà KeepArchivingDataForDays; oppure 2) siano stati esportati e selezionati per l'eliminazione.

Se impostato su False, i messaggi istantanei non verranno automaticamente eliminati dall'archivio.

KeepArchivingDataForDays

Facoltativo

Numero intero

Il numero di giorni (tra 1 e 2562) per cui i messaggi istantanei vengono conservati nell'archivio prima di essere automaticamente eliminati. Il valore predefinito è 14.

Questa proprietà ha effetto solo se EnablePurging è impostato su True.

PurgeExportedArchivesOnly

Facoltativo

Booleano

Se impostato su True, il sistema cancella solo i messaggi istantanei che sono stati esportati e, di conseguenza, selezionati per l'eliminazione. I messaggi istantanei che non sono stati esportati rimangono nell'archivio, anche nel caso in cui siano precedenti al valore specificato nella proprietà KeepArchivingDataForDays.

PurgeHourOfDay

Facoltativo

Numero intero

Indica l'ora in cui i record scaduti vengono eliminati dall'archivio. L'ora è specificata nel formato 24 ore, dalle ore 0 (mezzanotte) alle ore 23. Si noti che è possibile specificare solo l'ora. Ciò significa che è possibile pianificare l'eliminazione per 4:00 ma non, ad esempio, alle 4:30 o alle 4:15. Il valore predefinito è 2.

La cancellazione dall'archivio avviene solo 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.

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-CsArchivingConfiguration non accetta input tramite pipeline.

Tipi restituiti

New-CsArchivingConfiguration crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings.

Esempio

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

New-CsArchivingConfiguration -Identity site:Redmond -EnableArchiving "ImOnly"

Il comando riportato nell'Esempio 1 consente di creare una nuova raccolta di impostazioni di archiviazione e di applicarle al sito Redmond. Se si aggiunge il parametro EnableArchiving e lo si imposta su "ImOnly", il comando abilita anche l'archiviazione delle sessioni di messaggistica istantanea (ma non delle sessioni di conferenza via Web) per il sito Redmond.

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

$x = New-CsArchivingConfiguration -Identity site:Redmond -InMemory
$x.EnableArchiving = "ImOnly"
Set-CsArchivingConfiguration -Instance $x

Nell'esempio precedente viene illustrato l'utilizzo del parametro InMemory per creare una raccolta di impostazioni di configurazione dell'archiviazione inizialmente presenti solo in memoria. A tale scopo, nell'esempio viene creata una nuova raccolta di impostazioni (con Identity site:Redmond) e questa raccolta viene archiviata in una variabile denominata $x. Si noti che, dopo l'esecuzione del primo comando, la raccolta è presente solo in memoria. Se si esegue il comando Get-CsArchivingConfiguration, non sarà possibile vedere alcuna voce per site:Redmond.

Nel secondo comando, la proprietà EnableArchiving per questa raccolta virtuale viene impostata su "ImOnly" e ciò consente l'archiviazione della sessione di messaggistica istantanea. Infine, l'ultimo comando utilizza Set-CsArchivingConfiguration per trasformare le impostazioni di archiviazione virtuali in una raccolta di impostazioni effettive applicate al sito Redmond. Se non si utilizza il cmdlet Set-CsArchivingConfiguration, queste impostazioni rimangono solo nella memoria e pertanto sono destinate a scomparire al termine della sessione di Windows PowerShell o se la variabile $x viene eliminata.