Get-CsPersistentChatState
Returns the state of one or more Persistent Chat service pools. Persistent Chat pools can be in one of two states: Normal, in which the pool uses its primary databases; or FailedOver, in which the pool uses the backup databases defined in the topology. This cmdlet was introduced in Lync Server 2013.
Syntax
Filter
Get-CsPersistentChatState
[-Filter <String>]
[-LocalStore]
[<CommonParameters>]
Identity
Get-CsPersistentChatState
[[-Identity] <XdsIdentity>]
[-LocalStore]
[<CommonParameters>]
Description
The Get-CsPersistentChatState cmdlet returns the state of one or more Persistent Chat pools. Persistent Chat pools can be in either the Normal state (in which the pool uses its primary databases) or in a FailedOver state, in which the pool uses its backup databases. You can use the Set-CsPersistentChatState cmdlet to change the state of a Persistent Chat pool; when you change the state of the pool, Skype for Business Server 2015 will automatically change the state of each individual server in the pool.
The functions carried out by the Get-CsPersistentChatState cmdlet are not available in the Skype for Business Server Control Panel.
Examples
Example 1
Get-CsPersistentChatState
The command shown in Example 1 returns the state of all the Persistent Chat servers configured for use in the organization.
Example 2
Get-CsPersistentChatState -Identity "PersistentChatServer:atl-gc-001.litwareinc.com"
{Enter description for Example 2}
Example 3
Get-CsPersistentChatState -Filter "*.litwareinc.com"
Example 3 returns state information for all Persistent Chat servers in the domain litwareinc.com. To do this, the Filter parameter is included along with the filter value "*.litwareinc.com". That filter value causes the Get-CsPersistentChatState cmdlet to return information for all the Persistent Chat servers that have an Identity that ends with the string value ".litwareinc.com".
Example 4
Get-CsPersistentChatState | Where-Object {$_.PoolState -eq "FailedOver"}
The command shown in Example 4 returns state information for all the Persistent Chat servers that are currently failed over. To carry out this task, the command first calls the Get-CsPersistentChatState cmdlet without any parameters; that returns a collection of all the Persistent Chat servers in the organization. That collection is then piped to the Where-Object cmdlet, which picks out only those servers where the PoolState property is equal to (-eq) "FailedOver".
Parameters
-Filter
Applicable: Lync Server 2013, Skype for Business Server 2015
Enables you to use wildcards when retrieving one or more Persistent Chat states. For example, to return all the Persistent Chat states for the domain litwareinc.com, use this syntax:
-Filter "*.litwareinc.com"
You cannot use both the Filter parameter and the Identity parameter in the same command.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Filter
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Identity
Applicable: Lync Server 2013, Skype for Business Server 2015
Unique identifier for the Persistent Chat pool. For example:
-Identity "PersistentChatServer:atl-gc-001.litwareinc.com"
If this parameter is omitted then the Get-CsPersistentChatState cmdlet returns information for all your Persistent Chat states.
Parameter properties
| Type: | XdsIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Identity
| Position: | 2 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-LocalStore
Applicable: Lync Server 2013, Skype for Business Server 2015
Retrieves the Persistent Chat state data from the local replica of the Central Management store rather than from the Central Management store itself.
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 |
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.