Remove-CsArchivingPolicy
Ultima modifica dell'argomento: 2012-03-27
Consente di rimuovere i criteri di archiviazione della messaggistica istantanea (IM) specificati. Le regole di archiviazione IM determinano se Microsoft Lync Server 2010 salverà automaticamente tutte le sessioni IM effettuate tra utenti interni e/o tutte le sessioni IM fra utenti interni e partner federati.
Sintassi
Remove-CsArchivingPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Molte organizzazioni trovano utili conservare tutte le sessioni IM cui prendono parte i loro utenti, altre organizzazioni sono tenute a mantenerle come archivi. Per archiviare le sessioni IM con Lync Server 2010, è necessario eseguire due passi. Innanzitutto, è necessario abilitare l'archiviazione in ambito globale e/o di sito utilizzando il cmdlet Set-CsArchivingConfiguration. Questo fornisce la possibilità di archiviare sessioni IM. Tuttavia, l'archiviazione di tali sessioni non inizia automaticamente.
Per salvare effettivamente le trascrizioni delle sessioni di messaggistica istantanea, è necessario completare il passaggio 2, ovvero la creazione di uno o più criteri di archiviazione. Tali criteri determinano per quali utenti vengono registrate le sessioni di messaggistica istantanea oltre ai tipi di sessioni di messaggistica istantanea (interne e/o esterne) che 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 possono essere assegnati nell'ambito globale o del sito. Tali criteri possono inoltre essere assegnati nell'ambito per utente e quindi essere applicati a un utente o a un gruppo 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 per archiviare sia le sessioni interne che quelle esterne e applicare il criterio solo al personale addetto alle vendite. Poiché i criteri per utente hanno la precedenza sui criteri globali e di sito, per i membri dello staff di vendita verranno archiviate tutte le sessioni di messaggistica istantanea. Per tutti gli altri utenti, ovvero gli utenti che non appartengono al reparto vendite e a cui non viene applicato il criterio relativo alle vendite, verranno archiviate solamente le sessioni di messaggistica istantanea interne.
Il cmdlet Remove-CsArchivingPolicy consente di eliminare un criterio di archiviazione creato e utilizzato nell'organizzazione. Se si elimina un criterio per utente, tutti gli utenti ai quali era stato assegnato quel criterio cadranno automaticamente sotto la giurisdizione del criterio per sito appropriato. In assenza di un criterio per sito quegli utenti verranno regolati dal criterio globale. Se si rimuove un criterio per sito, gli utenti ai quali era stato assegnato quel criterio cadranno automaticamente sotto la giurisdizione del criterio globale.
Si noti che è possibile utilizzare il cmdlet Remove-CsArchivingPolicy su un criterio globale, ma non è possibile rimuovere un criterio globale. Se si utilizza il cmdlet Remove-CsArchivingPolicy su un criterio globale, per tutte le proprietà di quel criterio verranno ripristinati i valori predefiniti e di conseguenza non verrà archiviata alcuna sessione di messaggistica istantanea, né interna né esterna. Questo poiché il valore predefinito per quelle proprietà (ArchiveInternal e ArchiveExternal) è False.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsArchivingPolicy 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 "Remove-CsArchivingPolicy"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Identificatore univoco del criterio di archiviazione da rimuovere. È possibile configurare i criteri di archiviazione nell'ambito globale, del sito o di un singolo utente. Per rimuovere il criterio globale, utilizzare la seguente sintassi: -Identity global. Si noti che non è possibile eliminare un criterio globale. Ciò che accade è che per tutte le proprietà dei criteri verranno ripristinati i valori predefiniti. Per eliminare criteri del sito, usare una sintassi simile alla seguente: -Identity site:Redmond. Per eliminare criteri per utente, usare una sintassi simile alla seguente: -Identity SalesArchivingPolicy. I caratteri jolly non sono consentiti quando si specifica una identità. |
Force |
Facoltativo |
Parametro opzionale |
Se questo parametro è presente, il criterio verrà rimosso automaticamente anche se è assegnato ad almeno un utente. Se questo parametro non è presente, Remove-CsArchivingPolicy non rimuoverà automaticamente un criterio per utente che è assegnato ad almeno un utente. Verrà invece visualizzato un messaggio che richiede di confermare la rimozione del criterio. Per procedere con l'operazione e rimuovere il criterio, è necessario rispondere Sì (premendo il tasto Y). |
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 accetta gli input tramite pipeline dell'oggetto criterio di archiviazione.
Tipi restituiti
Remove-CsArchivingPolicy non restituisce alcun oggetto o valore. Il cmdlet rimuove le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.IM.IMArchivingPolicy.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsArchivingPolicy -Identity site:Redmond
Nell'esempio precedente, Remove-CsArchivingPolicy viene utilizzato per eliminare il criterio con identità site:Redmond. Si noti che, quando viene eliminato un criterio configurato nell'ambito del sito, agli utenti precedentemente gestiti da quel criterio verrà automaticamente assegnato il criterio di archiviazione globale.
-------------------------- Esempio 2 --------------------------
Get-CsArchivingPolicy -Filter site:* | Remove-CsArchivingPolicy
Nell'Esempio 2, vengono rimossi tutti i criteri di archiviazione che erano stati configurati nell'ambito del sito. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsArchivingPolicy e il parametro Filter per ottenere una raccolta di tutti i criteri di archiviazione assegnati nell'ambito del sito. Per ottenere questo risultato, viene utilizzato il valore del filtro "site:*"; questo valore fa in modo che il cmdlet Get-CsArchivingPolicy restituisca solo quei criteri la cui identità inizia con "site:". La raccolta così ottenuta viene inviata tramite pipe al cmdlet Remove-CsArchivingPolicy che elimina tutti i criteri nella raccolta.
-------------------------- Esempio 3 --------------------------
Get-CsArchivingPolicy | Where-Object {$_.ArchiveExternal -eq $False} | Remove-CsArchivingPolicy
Il comando precedente consente di eliminare tutti i criteri di archiviazione in cui la proprietà ArchiveExternal è impostata su False. Per ottenere questo risultato, viene utilizzato prima il cmdlet Get-CsArchivingPolicy per ottenere una raccolta di tutti i criteri di archiviazione configurati per l'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quei criteri in cui la proprietà ArchiveExternal è uguale a False. La raccolta filtrata viene quindi inviata al cmdlet Remove-CsArchivingPolicy che elimina ogni criterio nella raccolta.
Vedere anche
Ulteriori risorse
Get-CsArchivingPolicy
Grant-CsArchivingPolicy
New-CsArchivingPolicy
Set-CsArchivingPolicy