Set-CsArchivingPolicy
Ultima modifica dell'argomento: 2012-03-26
Modifica un criterio di archiviazione di messaggistica istantanea esistente. Un criterio di archiviazione consente di archiviare tutte le sessioni di messaggistica istantanea e le conferenze che avvengono tra gli utenti interni; è inoltre possibile archiviare le sessioni che avvengono tra utenti interni e partner federati.
Sintassi
Set-CsArchivingPolicy [-Identity <XdsIdentity>] [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsArchivingPolicy [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Molte organizzazioni ritengono utile conservare un archivio di tutte le sessioni di messaggistica istantanea a cui prendono parte gli utenti. Altre organizzazioni sono obbligate a mantenere tale archivio per legge. 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 le trascrizioni delle sessioni di messaggistica istantanea, è necessario completare il secondo passaggio: creare uno o più criteri di archiviazione che determinano per quali utenti vengono registrate le sessioni di messaggistica istantanea e quali tipi di sessioni di messaggistica istantanea (interne e/o esterne) vengono archiviati. 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 solo le sessioni interne, solo le sessioni esterne oppure entrambi i tipi.
I criteri di archiviazione (creati con il cmdlet New-CsArchivingPolicy) possono essere assegnati al sito globale o nell'ambito del sito. Inoltre, questi criteri possono essere assegnati nell'ambito per utente: in pratica, è possibile creare un criterio e applicarlo a un utente o a un gruppo di utenti specifico. Ad esempio, si potrebbe disporre di un criterio globale che consente di archiviare sessioni di messaggistica istantanea interne per tutti gli utenti. A questo si potrebbe aggiungere 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 (che non appartengono al reparto delle vendite e che non sono soggetti ai criteri delle vendite) verranno archiviate solamente le sessioni di messaggistica istantanea interne.
Il cmdlet Set-CsArchivingPolicy consente di modificare i valori delle proprietà per qualsiasi criterio di archiviazione delle sessioni di messaggistica istantanea attualmente in uso nell'organizzazione.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsArchivingPolicy 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-CsArchivingPolicy"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
Identificatore univoco per il criterio di archiviazione da modificare. I criteri di archiviazione possono essere configurati negli ambiti globale, di sito o per utente. Per modificare il criterio globale, utilizzare la sintassi seguente: -Identity global. Per modificare un criterio di sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Per modificare un criterio per utente, utilizzare una sintassi simile alla seguente: -Identity SalesArchivingPolicy. Se questo parametro non viene specificato, verrà modificato il criterio globale. Per specificare un'identità non sono consentiti i caratteri jolly. |
Instance |
Facoltativo |
Oggetto IMArchivingPolicy |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. |
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 un testo aggiuntivo riguardante il criterio. Ad esempio, è possibile utilizzare la proprietà Description per specificare gli utenti a cui dovrebbe essere applicato il criterio. |
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.Policy.IM.IMArchivingPolicy. Remove-CsArchivingPolicy consente di accettare l'input da pipeline di oggetti criterio di archiviazione.
Tipi restituiti
Set-CsArchivingPolicy non restituisce alcun oggetto o valore. Il cmdlet, invece, consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Policy.IM.IMArchivingPolicy.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsArchivingPolicy -Identity global -ArchiveInternal $True
Con questo esempio viene utilizzato Set-CsArchivingPolicy per modificare il criterio di archiviazione globale. In questo caso, la proprietà ArchiveInternal è impostata su True.
-------------------------- Esempio 2 --------------------------
Get-CsArchivingPolicy | Set-CsArchivingPolicy -ArchiveInternal $True
L'esempio 2 è una variazione del comando mostrato nell'esempio 1. Questa volta, però, tutti i criteri di archiviazione dell'organizzazione sono configurati per consentire l'archiviazione delle sessioni di messaggistica istantanea. Per ottenere tale risultato, il comando utilizza per prima cosa Get-CsArchivingPolicy per restituire una raccolta di tutti i criteri di archiviazione delle sessioni di messaggistica istantanea in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Set-CsArchivingPolicy, che imposta la proprietà ArchiveInternal di ciascun criterio su True.
Vedere anche
Ulteriori risorse
Get-CsArchivingPolicy
Grant-CsArchivingPolicy
New-CsArchivingPolicy
Remove-CsArchivingPolicy