Condividi tramite

  • Articolo

Grant-CsArchivingPolicy

 

Ultima modifica dell'argomento: 2012-03-23

Consente di assegnare criteri di archiviazione delle sessioni di messaggistica istantanea agli utenti o ai set di utenti. 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

Grant-CsArchivingPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <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 delle trascrizioni delle sessioni di messaggistica istantanea è necessario completare il secondo passaggio: creare uno o più criteri di archiviazione delle sessioni di messaggistica istantanea. Questi criteri determinano per quali utenti vengono registrate le sessioni di messaggistica istantanea e quali tipi di sessioni di messaggistica istantanea (interne e/o esterne) vengono archiviate. Le sessioni di messaggistica istantanea interne sono sessioni in cui tutti i partecipanti sono utenti autenticati che dispongono di account Active Directory nell'organizzazione. Le sessioni di messaggistica istantanea esterne, invece, sono sessioni in cui almeno uno dei partecipanti è un utente non autenticato che non dispone di un account Active Directory nell'organizzazione. È possibile scegliere di archiviare soltanto sessioni interne, soltanto 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. 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 Grant-CsArchivingPolicy è utilizzato per assegnare i criteri di archiviazione per utente a un utente o a un set di utenti specificato.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Grant-CsArchivingPolicy in locale: RTCUniversalUserAdmins. 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 "Grant-CsArchivingPolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Indica l'identità dell'account utente a cui assegnare i criteri. Le identità utente possono essere specificate con uno dei quattro formati riportati di seguito: 1) L'indirizzo SIP dell'utente; 2) il nome dell'entità utente (UPN); 3) il nome del dominio dell'utente e il nome di accesso nel formato dominio\accesso (ad esempio litwareinc\davidegarghentini); 4) il nome visualizzato in Servizi di dominio Active Directory dell'utente (ad esempio, Davide Garghentini). Le identità utente possono essere referenziate anche utilizzando il nome distinto dell'utente in Active Directory.

È inoltre possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il nome visualizzato come valore Identity dell'utente. L'identità "* Smith" restituisce ad esempio tutti gli utenti il cui nome visualizzato termina con il valore stringa " Smith".

PolicyName

Obbligatorio

Stringa

Il "Nome" del criterio da assegnare. PolicyName corrisponde all'identità del criterio meno il designatore di ambito "tag:". Ad esempio, un criterio con Identity tag:Redmond dispone di un PolicyName uguale a Redmond; un criterio con Identity tag:RedmondArchivingPolicy dispone di un PolicyName uguale a RedmondArchivingPolicy.

Per rimuovere un criterio per utente assegnato a un utente, impostare PolicyName su un valore null:

-PolicyName $Null

DomainController

Facoltativo

Stringa

Consente di specificare un controller di dominio a cui connettersi durante l'assegnazione dei criteri. Se il parametro non è incluso, il cmdlet utilizzerà il primo controller di dominio disponibile.

PassThru

Facoltativo

Parametro opzionale

Se presente, il cmdlet passa l'oggetto (o gli oggetti) utente attraverso la pipeline di Windows PowerShell. Per impostazione predefinita, Grant-CsArchivingPolicy non passa alcun oggetto attraverso la pipeline.

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

Valore stringa oppure oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Grant-CsArchivingPolicy accetta l'input da pipeline di valori stringa che rappresentano l'identità di un account utente. Il cmdlet accetta inoltre l'input da pipeline di oggetti utente.

Tipi restituiti

Grant-CsArchivingPolicy non restituisce alcun oggetto o valore. In realtà il cmdlet assegna le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.IM.ImArchivingPolicy agli utenti o ai gruppi di utenti. Tuttavia, se si include il parametro PassThru, il cmdlet restituisce istanze di Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Esempio

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

Grant-CsArchivingPolicy -Identity "Ken Myer" -PolicyName RedmondArchivingPolicy

Con l'esempio 1 il criterio di archiviazione RedmondArchivingPolicy viene assegnato all'utente con nome visualizzato "Davide Garghentini". Nel caso di Grant-CsArchivingPolicy, la proprietà Identity fa riferimento all'identità dell'utente, non del criterio di archiviazione. Il criterio deve invece essere assegnato con il parametro PolicyName; il valore del parametro è l'identità del criterio (ad esclusione del prefisso "tag:" ).

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

Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy

Nel comando precedente, a tutti gli utenti con account nell'unità organizzativa Redmond (OU) viene assegnato il criterio di archiviazione RedmondArchivingPolicy. A tal fine, vengono utilizzati Get-CsUser e il parametro OU per restituire una raccolta di tutti gli utenti che dispongono di account nell'unità organizzativa con il nome distinto "OU=Redmond,dc=litwareinc,dc=com". La raccolta viene quindi inviata tramite pipe a Grant-CsArchivingPolicy, che assegna il criterio RedmondArchivingPolicy ad ogni utente nella raccolta.

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

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy

Con il comando mostrato nell'esempio 3 viene assegnato il criterio RedmondArchivingPolicy a tutti gli utenti che lavorano a Redmond. Per eseguire questa operazione viene richiamato il cmdlet Get-CsUser con il parametro LdapFilter; il valore del filtro LDAP "l=Redmond" restituisce una raccolta di tutti gli utenti che lavorano nella città di Redmond. Nel linguaggio di query LDAP, l (elle minuscola) è l'abbreviazione di "località" e corrisponde quindi alla città. La raccolta viene quindi inviata tramite pipe a Grant-CsArchivingPolicy, che assegna il criterio RedmondArchivingPolicy ad ogni utente nella raccolta.

-------------------------- Esempio 4 --------------------------

Get-CsUser -Filter {RegistrarPool -eq "atl-cs-001.litwareinc.com"} | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy

Con l'esempio 4 a tutti gli utenti residenti nel pool di registrazione atl-cs-001.litwareinc.com viene assegnato il criterio RedmondArchivingPolicy. Per ottenere tale risultato, viene prima utilizzato Get-CsUser per restituire tutti gli utenti abilitati per Lync Server. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo gli utenti il cui RegistrarPool equivale ad atl-cs-001-litwareinc.com. La raccolta filtrata viene quindi inviata tramite pipe a Grant-CsArchivingPolicy, che assegna il criterio RedmondArchivingPolicy ad ogni utente nella raccolta.

-------------------------- Esempio 5 --------------------------

Get-CsUser -Filter {ArchivingPolicy -eq "RedmondArchivingPolicy"} | Grant-CsArchivingPolicy -PolicyName "NorthAmericaArchivingPolicy"

Con l'esempio 5 vengono individuati tutti gli utenti a cui è stato assegnato il criterio RedmondArchivingPolicy, quindi a ciascuno di questi utenti viene assegnato un criterio diverso, NorthAmericaArchivingPolicy. Per eseguire questa operazione, viene utilizzato Get-CsUser per restituire una raccolta di tutti gli utenti abilitati per Lync Server; il parametro Filter e il valore del filtro {ArchivingPolicy -eq "RedmondArchivingPolicy"} limitano i dati restituiti agli account in cui ArchivingPolicy è uguale a "RedmondArchivingPolicy". La raccolta filtrata viene quindi inviata tramite pipe a Grant-CsArchivingPolicy, che assegna il criterio NorthAmericaArchivingPolicy ad ogni utente nella raccolta.

-------------------------- Esempio 6 --------------------------

Get-CsUser -Filter {ArchivingPolicy -eq "RedmondArchivingPolicy"} | Grant-CsArchivingPolicy -PolicyName $Null

L'esempio 6 è una variazione dell'esempio 5; questa volta il criterio RedmondArchivingPolicy viene rimosso dagli utenti a cui era stato assegnato in precedenza: chiamando Grant-CsArchivingPolicy con un PolicyName uguale a $Null vengono rimossi tutti i criteri per utente assegnati in precedenza.