Condividi tramite

  • Articolo

Set-CsArchivingConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Modifica una raccolta esistente di impostazioni di archiviazione della messaggistica istantanea.

Sintassi

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

Set-CsArchivingConfiguration [-ArchiveDuplicateMessages <$true | $false>] [-BlockOnArchiveFailure <$true | $false>] [-CachePurgingInterval <UInt32>] [-Confirm [<SwitchParameter>]] [-EnableArchiving <None | ImOnly | ImAndWebConf>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepArchivingDataForDays <UInt32>] [-PurgeExportedArchivesOnly <$true | $false>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Molte organizzazioni trovano utile trascrivere tutte le sessioni di messaggistica istantanea e le conferenze a cui partecipano gli utenti dell'organizzazione. In altri casi tali trascrizioni sono obbligatorie, ad esempio molte organizzazioni del settore finanziario sono tenute per legge a conservare copie di tutte le comunicazioni elettroniche.

Per poter archiviare la messaggistica istantanea, è necessario configurare almeno un Server di archiviazione. Una volta configurato il Server di archiviazione, è necessario eseguire due passaggi ulteriori. È innanzitutto necessario abilitare l'archiviazione per l'ambito globale (per informazioni dettagliate vedere l'argomento Set-CsArchivingConfiguration). Facoltativamente, è anche possibile configurare le impostazioni di archiviazione per altri siti.

In secondo luogo, è necessario utilizzare i criteri di archiviazione per indicare gli utenti le cui sessioni di messaggistica istantanea verranno archiviate. le sessioni di messaggistica istantanea non verranno archiviate se non è presente un criterio che richiede l'archiviazione di tali sessioni.

Quando si installa Lync Server 2010, viene creata automaticamente una raccolta di impostazioni di configurazione dell'archiviazione globali. Per impostazione predefinita, tali impostazioni verranno applicate all'intera organizzazione. In alternativa, è possibile utilizzare il cmdlet New-CsArchivingConfiguration per creare impostazioni di configurazione personalizzate per i singoli siti. In entrambi i casi, è possibile utilizzare il cmdlet Set-CsArchivingConfiguration per modificare i valori delle proprietà di una raccolta o delle impostazioni di configurazione dell'archiviazione.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Set-CsArchivingConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsArchivingConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Rappresenta l'identificatore univoco della raccolta di impostazioni di archiviazione da modificare. Per modificare le impostazioni globali, escludere questo parametro o utilizzare la sintassi seguente: -Identity global. Per modificare le impostazioni nell'ambito del sito, utilizzare il prefisso "site:" seguito dal nome del sito. Ad esempio: -Identity "site:Redmond".

Instance

Facoltativo

Oggetto ArchivingSettings

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

ArchiveDuplicateMessages

Facoltativo

Booleano

Specifica la modalità di archiviazione dei messaggi istantanei relativi a più pool. Si consideri un semplice esempio: Davide Garghentini, che ha un account nel pool 1, invia un messaggio istantaneo a Luisa Cazzaniga, che ha un account nel 2. Pilar, a sua volta, invia una risposta al messaggio istantaneo di Ken. Se ArchiveDuplicateMessages è impostato su False, in base a un algoritmo predefinito la trascrizione della sessione verrà registrata nel pool 1 o nel pool 2, ma non in entrambi. Se ArchiveDuplicateMessages è impostato su True, ovvero 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 i messaggi istantanei non possono essere archiviati. Se impostato su False, ovvero il valore predefinito, la messaggistica istantanea continuerà anche se non è possibile archiviare i messaggi istantanei.

CachePurgingInterval

Facoltativo

Numero intero

Indica con quale frequenza, in ore, vengono cancellate le trascrizioni quando l'archiviazione non è stata abilitata per nessuno dei partecipanti. Per impostazione predefinita, tutti i gruppi di sessioni di messaggistica istantanea e di conferenze vengono registrati nel momento in cui si svolgono. All'intervallo specificato, il sistema valuta se l'archiviazione è stata abilitata per qualche partecipante delle sessioni. Se viene rilevata una sessione in cui l'archiviazione non è stata abilitata per alcun partecipante, la trascrizione corrispondente verrà eliminata dal database.

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

EnableArchiving

Facoltativo

Stringa

Indica quali termini vengono salvati nel database di archiviazione. I valori validi sono:

None. Nessun elemento viene archiviato nel database. Questo è il valore predefinito.

ImOnly. Le sessioni di messaggistica istantanea vengono archiviate nel database.

ImAndWebConf. Sia le sessioni di messaggistica istantanea che quelle di conferenze Web vengono archiviate nel database.

EnablePurging

Facoltativo

Booleano

Se impostato su True, i messaggi istantanei archiviati verranno rimossi periodicamente dal database, nei seguenti casi: 1) i messaggi istantanei risalgono a una data precedente al valore specificato nella proprietà KeepArchivingDataForDays; oppure 2) sono stati esportati e contrassegnati per l'eliminazione.

Se impostato su False, i messaggi istantanei non verranno eliminati automaticamente dal database.

KeepArchivingDataForDays

Facoltativo

Numero intero

Numero di giorni, compreso tra 1 e 2562, durante i quali i messaggi istantanei vengono conservati nel database prima di essere eliminati automaticamente. Il valore predefinito è 14.

Questa proprietà viene applicata solo se EnablePurging è impostato su True.

PurgeExportedArchivesOnly

Facoltativo

Booleano

Se impostato su True, verranno cancellati solo i messaggi istantanei che sono stato esportati, e pertanto contrassegnati per l'eliminazione. I messaggi istantanei che non sono stati esportati resteranno nel database, anche se risalgono a una data precedente al valore specificato nella proprietà KeepArchivingDataForDays.

PurgeHourOfDay

Facoltativo

Numero intero

Indica il momento del giorno in cui i record scaduti vengono eliminati dal database di archiviazione. L'ora del giorno viene specificata nel formato 24 ore; 0 rappresenta la mezzanotte, 23 rappresenta le 11 di sera. È possibile specificare solo l'ora del giorno. Pertanto è possibile pianificare la cancellazione per le 4.00 ma non per le 4.30 o le 4.15. Il valore predefinito è 2 (2.00).

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

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings. Set-CsArchivingConfiguration accetta input inviato tramite pipe degli oggetti di configurazione dell'archiviazione.

Tipi restituiti

Set-CsArchivingConfiguration non restituisce un valore o un oggetto. Il cmdlet configura invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings.

Esempio

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

Set-CsArchivingConfiguration -Identity site:Redmond -ArchiveDuplicateMessages $False -KeepArchivingDataForDays 30

Nell'esempio precedente, Set-CsArchivingConfiguration viene utilizzato per modificare due proprietà delle impostazioni di configurazione dell'archiviazione con identità site:Redmond. Il comando imposta prima la proprietà ArchiveDuplicateMessages su False per impedire che il server archivi la stessa sessione di messaggistica istantanea più volte. Viene utilizzato anche il parametro KeepArchivingDataForDays per configurare il server in modo da conservare i messaggi istantanei per 30 giorni.

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

Get-CsArchivingConfiguration -Filter "site:*" | Set-CsArchivingConfiguration -ArchiveDuplicateMessages $False -KeepArchivingDataForDays 30

L'esempio 2 è una variazione del comando mostrato nel primo esempio: in questo caso i valori delle proprietà ArchiveDuplicateMessages e KeepArchivingDataForDays vengono tuttavia modificati per tutte le impostazioni di archiviazione che sono state configurate nell'ambito del sito. Per eseguire questa operazione, il comando utilizza per prima cosa Get-CsArchivingConfiguration e il parametro Filter per restituire una raccolta di tutte le impostazioni di archiviazione configurate nell'ambito del sito; il valore di filtro "site:*" garantisce che vengano restituite solo le impostazioni la cui identità inizia con il valore stringa "site:". La raccolta filtrata viene quindi inviata tramite pipe a Set-CsArchivingConfiguration, che modifica i valori delle due proprietà per ogni elemento nella raccolta.

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

Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -eq "ImAndWebConf"} | Set-CsArchivingConfiguration -EnableArchiving "ImOnly"

Nell'esempio 3, tutte le impostazioni di configurazione dell'archiviazione che consentono l'archiviazione sia delle sessioni di messaggistica istantanea che delle conferenze vengono modificate. Quando il comando viene completato, tali impostazioni consentiranno l'archiviazione solo delle sessioni di messaggistica istantanea. Per questo scopo, viene chiamato prima Get-CsArchivingConfiguration senza parametri per restituire una raccolta di tutte le impostazioni di configurazione dell'archiviazione attualmente in uso nell'organizzazione. Tale raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che sceglie solo le impostazioni in cui la proprietà EnableArchiving è uguale a (-eq) "ImAndWebConf". La raccolta filtrata viene quindi inviata tramite pipe a Set-CsArchivingConfiguration, che modifica il valore di EnableArchiving in "ImOnly" per ogni elemento della raccolta.