Export (0) Print
Expand All
Expand Minimize

Get-CsArchivingConfiguration

 

Topic Last Modified: 2013-02-21

Returns information about how (or if) instant messaging (IM) sessions are archived in your organization. This cmdlet was introduced in Lync Server 2010.

Get-CsArchivingConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsArchivingConfiguration [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>]

The command shown in Example 1 returns a collection of all the archiving configuration settings in use in your organization.

Get-CsArchivingConfiguration

In Example 2, the Identity parameter is used to limit the returned collection of archiving configuration settings to those settings that have the Identity site:Redmond.

Get-CsArchivingConfiguration -Identity site:Redmond

In Example 3, the Filter parameter is used to limit the returned collection of archiving configuration settings to settings that have been configured at the site scope. The parameter value "site:*" limits the returned items to those that have an Identity that starts with the string value "site:".

Get-CsArchivingConfiguration -Filter site:*

This example uses the Get-CsArchivingConfiguration cmdlet to return a collection of all the archiving configuration settings that have been enabled for use in your organization. To do that, the command first calls the Get-CsArchivingConfiguration cmdlet without any parameters in order to return a collection of all your archiving configuration settings. That collection is then piped to the Where-Object cmdlet, which applies a filter that limits the returned data to those collections where the EnableArchiving property is not equal to "None". If EnableArchiving is set to "None", archiving has been disabled. If this property is set to any other value (either "IMOnly" or "ImAndWebConf") that means that archiving has been enabled.

Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -ne "None"}

Many organizations find it useful to keep a transcript of all the IM sessions carried out by their users (or a selected subset of users). For other organizations, it’s mandatory to keep such transcripts. For example, many organizations in the financial world are required by law to keep copies of all their electronic communications.

Lync Server gives you flexibility when it comes to archiving IM and web conferencing sessions. If you have deployed Archiving Server, you can use the various CsArchivingConfiguration cmdlets to enable and disable instant message archiving and to manage your archiving database. You can also suspend IM should archiving fail; this helps to ensure that you keep a record of all your electronic communications.

In order to archive IM sessions, you must set up at least one Archiving Server. After the Archiving Server is set up, you must perform two additional steps. First, you need to enable archiving at the appropriate scope (for details, see the Set-CsArchivingConfiguration cmdlet help topic). This might be the global scope; however, you can also configure custom archiving settings for different sites.

Second, you must use archiving policies to indicate which users will have their IM sessions archived. What happens if you enable archiving but do not assign any users a policy that specifies that their IM sessions should be archived? Literally, nothing happens: IM sessions will not be archived unless a policy is in force that requires IM sessions to be archived.

With the Get-CsArchivingConfiguration cmdlet, you can determine how IM session archiving has been configured in your organization.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsArchivingConfiguration cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself) run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsArchivingConfiguration"}

 

Parameter Required Type Description

Filter

Optional

System.String

Enables you to use wildcard characters in order to return a collection (or collections) of archiving configuration settings. To return a collection of all the settings configured at the site scope, use this syntax: -Filter site:*. To return a collection of all the settings that have the string value "Canada" somewhere in their Identity (the only property you can filter on) use this syntax: -Filter "*Canada*".

Identity

Optional

Microsoft.Rtc.Management.Xds.XdsIdentity

Indicates the unique identifier for the collection of archiving settings you want to return. To refer to the global settings use this syntax: -Identity global. To refer to a collection configured at the site scope, use syntax similar to this: -Identity site:Redmond. To return information about the settings assigned to an individual Registrar pool use syntax: like this:

-Identity "service:Registrar:atl-cs-001.litwareinc.com"

Pool-level settings are available only in Lync Server 2013.

Note that you cannot use wildcards when specifying an Identity. If you need to use wildcards, then include the Filter parameter instead.

If this parameter is not specified, then the Get-CsArchivingConfiguration cmdlet returns a collection of all the archiving configuration settings in use in the organization.

LocalStore

Optional

System.Management.Automation.SwitchParameter

Retrieves the archiving configuration data from the local replica of the Central Management store rather than from the Central Management store itself.

None. The Get-CsArchivingConfiguration cmdlet does not accept pipelined input.

The Get-CsArchivingConfiguration cmdlet returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings object.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft