New-CsStorageServiceConfiguration
Creates new instances of the Skype for Business Server Storage Service. The storage service provides a common infrastructure that enables Skype for Business Server components to use Exchange as a backend data store.
Syntax
Default (Default)
New-CsStorageServiceConfiguration
[-Identity] <XdsIdentity>
[-Confirm]
[-EnableAsyncAdaptorTaskAbort <Boolean>]
[-EnableAutoImportFlushedData <Boolean>]
[-EnableFabricReplicationSetReduction <Boolean>]
[-FabricInvalidStateTimeoutDuration <UInt64>]
[-Force]
[-InMemory]
[-WhatIf]
[<CommonParameters>]
Description
The Skype for Business Server Storage Service enables Skype for Business Server components, such as archiving, to use Exchange as a back-end data store. This helps to reduce operating costs: for example, you do not need to have separate storage solutions for Exchange archiving and for Skype for Business Server archiving. The Storage Service also enables Skype for Business Server to leverage the heavy investment that has been made in Exchange archiving and storage; and prevents administrators from having to use multiple tools to retrieve archived data.
Separate instances of the Skype for Business Server Storage Service can be configured at the global, site and service scope (for the Registrar service only).
By default, Skype for Business 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.
Skype for Business Server Control Panel: The functions carried out by the New-CsStorageServiceConfiguration cmdlet are not available in the Skype for Business Server Control Panel.
Examples
Example 1
New-CsStorageServiceConfiguration -Identity "site:Redmond"
The command shown in Example 1 creates a new collection of storage service configuration settings applied to the Redmond site.
Parameters
-Confirm
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Prompts you for confirmation before executing the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableAsyncAdaptorTaskAbort
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
PARAMVALUE: $true | $false
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableAutoImportFlushedData
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
PARAMVALUE: $true | $false
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableFabricReplicationSetReduction
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
PARAMVALUE: $true | $false
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-FabricInvalidStateTimeoutDuration
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
PARAMVALUE: UInt64
Parameter properties
| Type: | UInt64 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Suppresses the display of any nonfatal error message that might occur when running the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Identity
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
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.
Parameter properties
| Type: | XdsIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InMemory
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
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>.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Describes what would happen if you executed the command without actually executing the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
None
The New-CsStorageServiceConfiguration cmdlet does not accept pipelined input.
Outputs
Microsoft.Rtc.Management.WritableConfig.Settings.StorageService.StorageServiceSettings
The New-CsStorageServiceConfiguration cmdlet creates new instances of the Microsoft.Rtc.Management.WritableConfig.Settings.StorageService.StorageServiceSettings object.