Export (0) Print
Expand All

Set-CsStorageServiceConfiguration

 

Topic Last Modified: 2013-02-20

Modifies 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 Cumulative Updates for Lync Server 2013: February 2013.

Set-CsStorageServiceConfiguration [[-Identity] <XdsIdentity>] [-Force] [-WhatIf] [-Confirm][<CommonParameters>]Set-CsStorageServiceConfiguration [-Instance <psobject>] [-Force] [-WhatIf] [-Confirm][<CommonParameters>]

The command shown in Example 1 modifies the storage service configuration settings applied to the Redmond site. In this example, the EnableAutoImportFlushedData property is set to False ($False).

Set-CsStorageServiceConfiguration -Identity "site:Redmond" -EnableAutoImportFlushedData $False

In Example 2, the same modification (disabling the autoimport of flushed data) is made to all the storage service configuration settings in use in the organization. To do this, the command first calls the Get-CsStorageServiceConfiguration cmdlet without any parameters in order to return a collection of all the available settings. That collection is then piped to the Set-CsStorageServiceConfiguration cmdlet, which takes each item in the collection and sets the value of the EnableAutoImportFlushedData property False ($False).

Get-CsStorageServiceConfiguration | Set-CsStorageServiceConfiguration -EnableAutoImportFlushedData $False

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 (as well as the settings in the global collection) can later be modified by using the Set-CsStorageServiceConfiguration cmdlet.

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 command-line interface prompt:

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

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

 

Parameter Required Type Description

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command.

EnableAutoImportFlushedData

Optional

System.Boolean

When set to True (the default value), Lync Server will automatically attempt to re-import any data that has been flushed from the Lync Server Storage Service.

EnableFabricReplicationSetReduction

Optional

System.Boolean

When set to True (the default value), supports a reduction in the number of replication sets. A replication set consists of a primary storage volume and all its associated volumes.

Force

Optional

System.Management.Automation.SwitchParameter

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

Identity

Optional

Microsoft.Rtc.Management.Xds.XdsIdentity

Unique identifier for the storage service configuration settings to be modified. Storage service configuration settings can be applied to the global, site, or service scope (for the Registrar service only).

To modify the global settings, use this syntax:

-Identity global

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

-Identity "site:Redmond"

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

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

Instance

Optional

Microsoft.Rtc.Management.WritableConfig.Settings.storageService.StorageServiceSettings object

Allows you to pass a reference to an object to the cmdlet rather than set individual parameter values.

WhatIf

Optional

System.Management.Automation.SwitchParameter

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

The Set-CsStorageServiceConfiguration cmdlet accepts pipelined instances of the Microsoft.Rtc.Management.WritableConfig.Settings.storageService.StorageServiceSettings object.

None. The Set-CsStorageServiceConfiguration cmdlet does not return any data or objects.

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