Get-CsPoolFabricState

Returns the Windows Fabric state for a Skype for Business Server pool. Windows Fabric is a Microsoft technology used for creating highly reliable, distributable, and scalable applications. This cmdlet was introduced in Lync Server 2013.

Syntax

Get-CsPoolFabricState
   -PoolFqdn <String>
   [-Confirm]
   [-Force]
   [-Type <FabricEnumerationType>]
   [-WhatIf]
   [<CommonParameters>]
Get-CsPoolFabricState
   [-PoolFqdn] <String>
   [-Confirm]
   [-Force]
   [-HealthState <String>]
   [-OutputCsvFile <String>]
   [-ServiceName <String>]
   [-ShowAll]
   [-WhatIf]
   [-Type <String>]
   [<CommonParameters>]
Get-CsPoolFabricState
   [-RoutingGroup] <String>
   [-Confirm]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Get-CsPoolFabricState
   [-Tenant] <Guid>
   [-Confirm]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Get-CsPoolFabricState
   [-UserUri] <UserIdParameter>
   [-Confirm]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Description

The Get-CsPoolFabricState cmdlet returns the Windows Fabric state for a Skype for Business Server pool. This includes information about Windows Fabric replica instances for any (or all) of the following services: MCU factory; Conference Directory; Routing; Skype for Business Server Storage Service.

The functions carried out by the Get-CsPoolFabricState cmdlet are not available in Skype for Business Server Control Panel.

Examples

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

Get-CsPoolFabricState -PoolFqdn "atl-cs-001.litwareinc.com"

The command shown in Example 1 returns the fabric state for the pool atl-cs-001.litwareinc.com. Because the Type parameter was not included, state information for all the services on the pool will be returned.

-------------------------- Example 2 --------------------------

Get-CsPoolFabricState -PoolFqdn "atl-cs-001.litwareinc.com" -Type MCU

Example 2 returns the fabric state for a single service on the pool atl-cs-001.litwareinc.com: the MCU factory service. This is done by including the Type parameter and the parameter value "MCU".

Parameters

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
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

-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

-HealthState

PARAMVALUE: String

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

-OutputCsvFile

PARAMVALUE: String

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

-PoolFqdn

Fully qualified domain name of the pool being checked. You must supply the FQDN of a pool when calling this cmdlet; for example:

-PoolFqdn "atl-cs-001.litwareinc.com"

Type:String
Position:1
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

-RoutingGroup

Globally unique identifier (GUID) of the Windows Fabric routing group to be returned. Routing groups are used to specify the servers that users log onto.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-ServiceName

PARAMVALUE: String

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

-ShowAll

PARAMVALUE: SwitchParameter

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

-Tenant

Globally unique identifier (GUID) of the Skype for Business Online tenant account whose Windows Fabric pool state is being returned. For example:

-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

You can return the tenant ID for each of your Skype for Business Online tenants by running this command:

Get-CsTenant | Select-Object DisplayName, TenantID

Type:Guid
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-Type

Specifies the service type to be returned. Allowed values are:

  • All (returns information for all services)
  • MCUFactory (returns information for the MCU factory service)
  • ConferenceDirectory (returns information for the Conference Directory service)

LYSS (returns information for the Lync Server Storage service)

You can only specify a single type per command.

Type:FabricEnumerationType
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

-UserUri

Enables you to check the Windows fabric state for the pool used by a specific user. For example, to check the Windows fabric state for the user Ken Myer use this syntax:

-UserUri "sip:kenmyer@litwareinc.com"

Note that you can only specify one user URI per command.

Type:UserIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
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

Outputs

String

String value representing the fabric state.