Topic Last Modified: 2014-03-19

Creates new 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 backend data store.

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

Syntax

New-CsStorageServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Examples

Example 1

The command shown in Example 1 creates a new collection of storage service configuration settings applied to the Redmond site. In this example, the autoimport of flushed data is disabled. You do this by setting the EnableAutoImportFlushedData parameter to False ($False).

Copy Code
New-CsStorageServiceConfiguration -Identity "site:Redmond" -EnableAutoImportFlushedData $False

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. Those custom settings can later be deleted by using the Remove-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 yourself), run the following command from the Windows PowerShell command-line interface prompt:

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

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

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Rtc.Management.Xds.XdsIdentity

Unique identifier for the new collection of storage service configuration settings to be created. Storage service settings can be created at the site scope or the service scope (but only for the Registrar service). To create a new collections of settings at the site scope, use syntax similar to this:

-Identity "site:Redmond"

To create settings at the service scope, use syntax similar to this:

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

Note that your command will fail if the specified site or service already hosts a collection of storage service configuration settings.

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command.

Force

Optional

System.Management.Automation.SwitchParameter

Suppresses the display of any nonfatal error message that might occur when running the command.

InMemory

Optional

System.Management.Automation.SwitchParameter

Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Describes what would happen if you executed the command without actually executing the command.

Input Types

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

Return Types

The New-CsStorageServiceConfiguration cmdlet creates new instances of the Microsoft.Rtc.Management.WritableConfig.Settings.storageService.StorageServiceSettings object.

See Also