Invoke-CsStorageServiceFlush

Flushes the Skype for Business Server Storage Service database on each Front End server in a pool. Flushing a database involves writing all the queued data to disk, and then clearing the database queue. This cmdlet was introduced in Lync Server 2013.

Syntax

Invoke-CsStorageServiceFlush
      -FlushType <FlushType>
      -PoolFqdn <Fqdn>
      [-Binding <String>]
      [-Force]
      [-HostNameStorageService <String>]
      [-WaitTime <TimeSpan>]
      [<CommonParameters>]

Description

The Skype for Business Server Storage Service provides a common interface and infrastructure for managing Skype for Business Server data, including session data for monitoring, archiving, and conversation history, as well as for integrating with the Exchange storage system. Like other databases, the Storage Service caches data in memory and then, as system resources permit, periodically writes that data to disk.

As a general rule, administrators do not have to interact with this queued data. However, there could be times when the queue becomes too large or because the Registrar pool associated with the database is being failed over. In cases like that, the Invoke-CsStorageServiceFlush cmdlet can be called in order to write all the queued data to disk and then clear the database cache.

The Invoke-CsStorageServiceFlush cmdlet is also useful when multiple Front End servers must be shut down at the same time (for example, in order to do a software upgrade). As a general rule, Front End servers in a pool should be shut down, and restarted, one-by-one; that helps prevent data loss that could occur due to routing group rebalancing. However, there might be occasions when you need to shutdown multiple servers at the same time. To help guard against potential loss, you can run the Invoke-CsStorageServiceFlush cmdlet before doing the computer shutdowns. This will flush the queue for the pool and write all that data to disk before any of the servers are actually shut down.

Skype for Business Server Control Panel: The functions carried out by the Invoke-CsStorageServiceFlush cmdlet are not available in the Skype for Business Server Control Panel.

Examples

-------------------------- Example 1 --------------------------

Invoke-CsStorageServiceFlush -PoolFqdn "atl-cs-001.litwareinc.com" -FlushType "SteadyState"

The command shown in Example 1 performs a "steady state" flush of the Storage Service databases found on the pool atl-cs-011.litwareinc.com. In a steady state flush, the only data removed from the queue (and written to disk) is data that can be removed without affecting the database operation.

Parameters

-Binding

Windows Communication Foundation (WCF) binding. A WCF binding determines the transport, encoding, and protocol details required for clients and services to communicate with each other. valid values are:

NetNamedPipe

NetTCP

Type:String
Aliases:b
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-FlushType

Specifies the type of storage flush to be performed. Allowed values are:

SteadyState - The only data that will be flushed is data that can be removed from the queue without affecting normal operations of the storage service. This is typically done to remove older data from the queue.

FullFlush - Flushes all the data from the queue. This is typically used when a pool is being failed over, and when there is no expectation that the queue will be receiving any new data.

Type:FlushType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Force

Suppresses the display of any non-fatal error message that might occur when running the command.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-HostNameStorageService

Fully qualified domain name of the server where the Skype for Business Server Storage Service is running. This parameter is required if the Binding is set to NetTCP.

Type:String
Aliases:h
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-PoolFqdn

Fully qualified domain name of the pool containing the storage service to be flushed.

Type:Fqdn
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WaitTime

Specifies the maximum amount of time the cmdlet will wait before assuming that flushing has begun and moving on to the next step in the flushing process.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Inputs

None. The Invoke-CsStorageServiceFlush cmdlet does not accept pipelined data.

Outputs

String value.