Topic Last Modified: 2014-03-19

Returns information about existing instances of the Lync Server Storage Service. The storage service provides a common infrastructure that enables Lync Server 2013 components to use Microsoft Exchange Server 2013 as a back-end data store.

This cmdlet was introduced in the Cumulative Updates for Lync Server 2013: February 2013.

Syntax

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

Examples

Example 1

The command shown in Example 1 returns information about all the storage service configuration settings in use in your organization.

Copy Code
Get-CsStorageServiceConfiguration

Example 2

In Example 2, information is returned for a single collection of storage service configuration settings: the collection of settings applied to the Redmond site.

Copy Code
Get-CsStorageServiceConfiguration -Identity "site:Redmond"

Example 3

Example 3 returns information for all the storage service configuration settings applied to the service scope. To do this, the command uses the Filter parameter and the filter value "service:*". This filter value limits returned data to collections that have an Identity that begins with the string value "service:".

Copy Code
Get-CsStorageServiceConfiguration -Filter "service:*"

Detailed Description

The Lync Server Storage Service (introduced in Lync Server 2013) enables Lync Server components, such as archiving for instant messaging and conferencing. to use Exchange 2013 as a back-end data store. This helps to reduce operating costs: for example, you no longer need to have separate storage solutions for Exchange and for Lync Server archiving. Among other things, the Storage Service also enables Lync Server to leverage the heavy investment that has been made in Exchange archiving and storage, and prevents administrators from having to use multiple tools when retrieving archived data.

Separate instances of the Lync Server Storage Service can be configured at the global, site, and service scope (for the Registrar service only). By default, Lync Server provides you with a single, global collection of Storage Service configuration settings. However, administrators have the option of creating custom settings by using the New-CsStorageServiceConfiguration cmdlet. Information about all of these Storage service settings can be returned by using the Get-CsStorageServiceConfiguration cmdlet.

To return a list of all the role-based access control (RBAC) roles that this cmdlet has been assigned to (including any custom RBAC roles you have created), run the following command from the Windows PowerShell command-line interface prompt:

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

Lync Server Control Panel: The functions carried out by the Get-CsStorageServiceConfiguration cmdlet are not available in the Lync Server Control Panel.

Parameters

Parameter Required Type Description

Filter

Optional

System.String

Enables you to use wildcards when retrieving one or more collections of storage service configuration settings. For example, to return all the settings configured at the site scope, use this syntax:

-Filter "site:*"

To return all the settings configured at the service scope, use this syntax:

-Filter "service:*"

Note that you cannot use both the Filter parameter and the Identity parameter in the same command.

Identity

Optional

Microsoft.Rtc.Management.Xds.XdsIdentity

Unique identifier for the storage service configuration settings to be returned. Storage service configuration settings can be applied to the global, site, or service scope (for the Registrar service only). To return a complete collection of storage service configuration settings, omit the Identity parameter.

Alternatively, you can use the Identity parameter to retrieve information for a specific collection of storage service configuration settings. To return just the global settings, use this syntax:

-Identity global

To return settings configured at the site scope, use syntax similar to this:

-Identity "site:Redmond"

To return settings at the service level, use syntax similar to this:

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

LocalStore

Optional

System.Management.Automation.SwitchParameter

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

Input Types

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

Return Types

The Get-CsStorageServiceConfiguration cmdlet returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.storageService.StorageServiceSettings object.

See Also