Get-FasServer

Synopsis

Retrieve information about the Federated Authentication Service (FAS) servers configured via Group Policy.

Syntax

Get-FasServer [-Address <String>] [-UserName <String>] [-Password <String>] [<CommonParameters>]
<!--NeedCopy-->

Description

This cmdlet returns information about the Federated Authentication Service (FAS) servers configured on this server via GPO. In particular this includes the addresses for remote configuration.

Additional information is returned about each contactable FAS server, including: - whether the FAS server is in maintenance mode, - whether KSP remoting is enabled, - whether the FAS server is permitted to automatically create user certificates while in maintenance mode.

See Set-FasServer for more details.

Examples

Example 1

PS C:\>

C:\PS> Get-FasServer
<!--NeedCopy-->

Description


This code lists the FAS Servers configured via Group Policy.

Example 2

PS C:\>

C:\PS> Get-FasServer -Address localhost
<!--NeedCopy-->

Description


This code returns information about the FAS server the command is being executed on.

Parameters

-Address

Specify a particular FAS server to contact (or omit to list all configured servers)

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: (list all configured servers)
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
<!--NeedCopy-->

-UserName

User name to use for authentication to FAS server ($NULL for current user account)

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: $NULL
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
<!--NeedCopy-->

-Password

Password for authentication to FAS server ($NULL for current user account)

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: $NULL
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
<!--NeedCopy-->

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Variable, based on property name.

This cmdlet does accept input from the pipeline but only by property name.

Outputs

void

This cmdlet returns a list of FAS server objects

Notes

Set-FasServer

Get-FasServer