Condividi tramite

  • Articolo

New-CsArchivingPolicy

 

Ultima modifica dell'argomento: 2012-03-23

Crea nuovi criteri di archiviazione per sessioni di messaggistica istantanea. Tali criteri consentono di archiviare tutte le sessioni di messaggistica istantanea che avvengono tra gli utenti interni e/o di archiviare tutte le sessioni di messaggistica istantanea che avvengono tra utenti interni e partner esterni.

Sintassi

New-CsArchivingPolicy -Identity <XdsIdentity> [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Per molte organizzazioni è utile conservare un archivio di tutte le sessioni di messaggistica istantanea cui prendono parte i propri utenti; altre organizzazioni sono obbligate per legge a detenere un archivio del genere. Per archiviare sessioni di messaggistica istantanea con Microsoft Lync Server 2010, è necessario eseguire due passaggi. Innanzitutto è necessario abilitare l'archiviazione nell'ambito globale e/o del sito utilizzando il cmdlet Set-CsArchivingConfiguration. Questo consente di poter archiviare sessioni di messaggistica istantanea. Tuttavia, l'archiviazione di tali sessioni non viene avviata automaticamente.

Per salvare effettivamente le trascrizioni di sessioni di messaggistica istantanea è infatti necessario completare il passaggio 2: creare uno o più criteri di archiviazione delle sessioni di messaggistica istantanea per determinare gli utenti di cui verranno registrate le sessioni nonché quale tipo di sessioni di messaggistica istantanea (interne e/o esterne) verranno archiviate. Le sessioni di messaggistica istantanea interne sono sessioni in cui tutti i partecipanti sono utenti autenticati che dispongono di account Active Directory all'interno dell'organizzazione; le sessioni di messaggistica istantanea esterne sono sessioni in cui almeno un partecipante è un utente non autenticato che non dispone di un account Active Directory all'interno dell'organizzazione. È possibile scegliere di archiviare soltanto sessioni interne, soltanto sessioni esterne oppure entrambi i tipi.

I criteri di archiviazione possono essere assegnati all'ambito globale o all'ambito del sito. Tali criteri possono inoltre essere assegnati all'ambito per utente e quindi essere applicati a un utente o a un insieme di utenti specifico. Si supponga ad esempio che il criterio globale in uso consenta di archiviare solo le sessioni di messaggistica istantanea interne per tutti gli utenti. In questo caso, si potrebbe creare un secondo criterio che archivia sia le sessioni interne sia le sessioni esterne, applicandolo solo al personale addetto alle vendite. Poiché i criteri per utente hanno la precedenza sui criteri globali e di sito, verranno archiviate tutte le sessioni di messaggistica istantanea dei membri dello staff vendite. Per tutti gli altri utenti, ovvero gli utenti che non appartengono al reparto vendite e che non sono soggetti al criterio relativo alle vendite, verranno archiviate solamente le sessioni di messaggistica istantanea interne.

È possibile creare nuovi criteri di archiviazione (nell'ambito del sito o per utente) utilizzando il cmdlet New-CsArchivingPolicy. Se viene creato un criterio nell'ambito del sito, questo verrà applicato automaticamente al sito nel momento stesso in cui il criterio viene creato. Se viene creato un criterio per utente, tale criterio non verrà utilizzato finché non verrà esplicitamente assegnato a un utente o un insieme di utenti richiamando il cmdlet Grant-CsArchivingPolicy. Non è possibile creare un nuovo criterio nell'ambito globale.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsArchivingPolicy 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 "New-CsArchivingPolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Indica l'identità univoca da assegnare al criterio. È possibile creare nuovi criteri di archiviazione nell'ambito del sito o nell'ambito per utente. Per creare un nuovo criterio di sito, utilizzare il prefisso "site:" seguito dal nome del sito. Ad esempio, questa sintassi consente di creare un nuovo criterio per il sito Redmond: -Identity site:Redmond. Per creare un nuovo criterio per utente utilizzare un'identità simile alla seguente: -Identity SalesArchivingPolicy.

Non è possibile creare un nuovo criterio globale; se si desidera apportare modifiche al criterio globale, utilizzare il cmdlet Set-CsArchivingPolicy. Analogamente, non è possibile creare un nuovo criterio di sito o per utente se è già presente un criterio con tale identità.

ArchiveExternal

Facoltativo

Booleano

Indica se vengono archiviate le sessioni di messaggistica istantanea esterne. Una sessione di messaggistica istantanea esterna è una sessione in cui almeno un partecipante è un utente non autenticato che non dispone di un account Active Directory all'interno dell'organizzazione. Il valore predefinito è False, ovvero le sessioni di messaggistica istantanea che includono utenti esterni non vengono archiviate.

ArchiveInternal

Facoltativo

Booleano

Indica se vengono archiviate le sessioni di messaggistica istantanea interne. Una sessione di messaggistica istantanea interna è una sessione in cui tutti i partecipanti sono utenti autenticati che dispongono di account Active Directory all'interno dell'organizzazione. Il valore predefinito è False, ovvero le sessioni di messaggistica istantanea interne non vengono archiviate.

Description

Facoltativo

Stringa

Consente agli amministratori di fornire una breve descrizione del criterio di archiviazione. Ad esempio, la descrizione potrebbe essere usata per indicare a quali utenti deve essere applicato il criterio.

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-CsArchivingPolicy non accetta l'input da pipeline.

Tipi restituiti

New-CsArchivingPolicy crea istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.IM.IMArchivingPolicy.

Esempio

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

New-CsArchivingPolicy -Identity site:Redmond -ArchiveInternal $True

Con l'esempio 1 viene utilizzato il cmdlet New-CsArchivingPolicy per creare un nuovo criterio di archiviazione con identità site:Redmond. Il parametro ArchiveInternal inoltre viene impostato su True, pertanto tale nuovo criterio consentirà di archiviare le sessioni di messaggistica istantanea interne e le conferenze.

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

$x = New-CsArchivingPolicy -Identity site:Redmond -InMemory
$x.ArchiveInternal = $True
$x.ArchiveExternal = $True
Set-CsArchivingPolicy -Instance $x

Nell'esempio 2 viene utilizzato il parametro InMemory per creare un criterio di archiviazione che inizialmente esista soltanto in memoria. In questo set di comandi viene innanzitutto richiamato il cmdlet New-CsArchivingPolicy, insieme al parametro InMemory, per creare un nuovo criterio di sito con identità site:Redmond. Questo nuovo criterio presente soltanto in memoria viene archiviato nella variabile $x. Nei comandi 2 e 3 i valori delle proprietà per tale criterio virtuale vengono modificati. Nel comando 2 il valore della proprietà ArchiveInternal viene impostato su True, mentre nel comando 3 la proprietà ArchiveExternal viene impostata su True.

Infine, con l'ultimo comando dell'esempio viene utilizzato il cmdlet Set-CsArchivingPolicy per trasformare il criterio virtuale site:Redmond in un criterio effettivo per l'archiviazione delle sessioni di messaggistica istantanea.