Condividi tramite

  • Articolo

Get-CsArchivingPolicy

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni relative ai criteri di archiviazione della sessione di messaggistica istantanea (IM). I criteri di archiviazione consentono di archiviare tutte le sessioni delle conferenze Web e IM che avvengono tra utenti interni e/o tra utenti interni e utenti esterni.

Sintassi

Get-CsArchivingPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsArchivingPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Molte organizzazioni trovano utile 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 Microsoft 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 delle sessioni di messaggistica istantanea. Tali 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 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 utilizzando il cmdlet New-CsArchivingPolicy) possono essere assegnati ad un ambito di sito o di sito globale. Inoltre, questi criteri possono essere assegnati ad un ambito per utente; ciò significa che si possono creare criteri ed applicarli a utenti specifici o a un gruppo di utenti specifico. Ad esempio, potrebbe essere presente un criterio globale che archivia le sessioni IM interne per tutti gli utenti. In aggiunta, si potrebbe creare un secondo criterio che archivia le sessioni sia interne sia esterne e applicarlo 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 IM dei membri dello staff delle vendite. Per tutti gli altri utenti (cioè quelli che non fanno parte del reparto vendite e che non sono soggetti ai criteri delle vendite) verranno archiviate solamente le sessioni interne di messaggistica istantanea.

Il cmdlet Get-CsArchivingPolicy restituisce informazioni relative ai criteri di archiviazione configurati per l'utilizzo nella propria organizzazione. Tenere presente che questi criteri vengono applicati solo se l'archiviazione della sessione IM è stata abilitata nell'ambito globale o di sito. Per determinare se è stata abilitata o meno l'archiviazione della sessione IM, utilizzare il cmdlet Get-CsArchivingConfiguration.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsArchivingPolicy può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsArchivingPolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore univoco dei criteri di archiviazione da restituire. Per fare riferimento al criterio globale, utilizzare la seguente sintassi: -Identity global. Per fare riferimento ad un criterio del sito, usare una sintassi simile alla seguente: -Identity site:Redmond. Per fare riferimento ad un criterio per utente, usare una sintassi simile alla seguente: -Identity RedmondArchivingPolicy. Se questo parametro viene omesso, verranno restituiti tutti i criteri di archiviazione configurati per l'utilizzo nella propria organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per specificare il criterio o i criteri da ottenere. Ad esempio, per ottenere tutti i criteri configurati nell'ambito del sito, utilizzare la seguente sintassi: -Filter "site:*". Consente di restituire ogni criterio in cui Identity (l'unica proprietà che è possibile filtrare) inizia con il valore di stringa "site:". Per ottenere una raccolta di tutti i criteri per utente la cui identità inizia con "Sales", utilizzare la sintassi seguente: -Filter "Sales*".

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati dei criteri di archiviazione dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsArchivingPolicy non accetta input tramite pipeline.

Tipi restituiti

Get-CsArchivingPolicy restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy.

Esempio

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

Get-CsArchivingPolicy

Nell'Esempio 1 viene utilizzato Get-CsArchivingPolicy senza alcun parametro. Viene così restituita una raccolta di tutti i criteri di archiviazione attualmente in uso nell'organizzazione,

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

Get-CsArchivingPolicy -Identity site:Redmond

Nell'Esempio 2, Get-CsArchivingPolicy viene utilizzato per ottenere il criterio di archiviazione con Identity site:Redmond. Poiché le identità devono essere univoche, il comando restituirà al massimo un criterio.

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

Get-CsArchivingPolicy -Filter tag:*

Il comando precedente restituisce una raccolta di tutti i criteri di archiviazione configurati nell'ambito per utente. Per ottenere questo risultato, vengono inclusi il parametro Filter e il valore "tag:*". Il valore del filtro indica al cmdlet Get-CsArchivingPolicy di restituire solo i criteri in cui l'identità inizia con il valore di stringa "tag:".

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

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False}

Nell'Esempio 4 viene restituita una raccolta di tutti i criteri di archiviazione in cui è stata disabilitata l'archiviazione delle sessioni IM interne. Per ottenere questo risultato, viene utilizzato prima il cmdlet Get-CsArchivingPolicy per ottenere una raccolta di tutti i criteri di archiviazione utilizzati al momento. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object. A sua volta, Where-Object applica un filtro che limita i dati restituiti a quei criteri in cui la proprietà ArchiveInternal è uguale a False.

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

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False -and $_.ArchiveExternal -eq $False}

L'Esempio 5 è simile all'Esempio 4. In questo caso, tuttavia, il comando restituisce tutti i criteri di archiviazione in cui è disabilitata l'archiviazione interna ed esterna. Per ottenere questo risultato, viene utilizzato prima il cmdlet Get-CsArchivingPolicy per ottenere una raccolta di tutti i criteri di archiviazione utilizzati al momento. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo quei criteri in cui entrambe le proprietà ArchiveInternal e ArchiveExternal sono uguali a False. L'operatore -and indica al cmdlet Where-Object di selezionare solo quei criteri che soddisfano tutti i criteri specificati. Per selezionare criteri che soddisfano solo uno o entrambi i criteri specificati utilizzare l'operatore -or:

Where-Object {$_.ArchiveInternal -eq $False -or $_.ArchiveExternal -eq $False}