Topic Last Modified: 2014-02-19

Returns the Windows Fabric state for a Lync Server 2013 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 -RoutingGroup <Guid> <COMMON PARAMETERS>
Get-CsPoolFabricState -Tenant <Guid> <COMMON PARAMETERS>
Get-CsPoolFabricState -UserUri <UserIdParameter> <COMMON PARAMETERS>
Get-CsPoolFabricState -PoolFqdn <String> [-Type <All | MCUFactory | ConferenceDirectory | Routing | LYSS>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Examples

Example 1

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.

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

Example 2

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".

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

Detailed Description

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

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 "Get-CsPoolFabricState"}

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

Parameters

Parameter Required Type Description

PoolFqdn

Required

System.String

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”

RoutingGroup

Required

System.Guid

PARAMVALUE: Guid

Tenant

Required

System.Guid

PARAMVALUE: Guid

UserUri

Required

Microsoft.Rtc.Management.AD.UserIdParameter

PARAMVALUE: UserIdParameter

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command.

Force

Optional

System.Management.Automation.SwitchParameter

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

Type

Optional

Microsoft.Rtc.Management.HADR.FabricState.GetOcsPoolFabricStateCmdlet+FabricEnumerationType

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.

WhatIf

Optional

System.Management.Automation.SwitchParameter

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

Input Types

None. The Get-CsPoolFabricState cmdlet does not support pipelined input.

Return Types

String value representing the fabric state. The Get-CsPoolFabricState cmdlet does not return objects.