New-FasCloudConfig

SYNOPSIS

Create the Federated Authentication Service (FAS) Cloud configuration.

SYNTAX

New-FasCloudConfig [-Rule <String>] [-Staging] [-CloudId <String>] [-CwsServiceUri <String>]
 [-GeoServiceUri <String>] [-SilentAuth] [-ClientId <String>] [-ClientSecret <String>] [-Customer <String>]
 [-ResourceLocationId <String>] [-Address <String>] [-UserName <String>] [-Password <String>]
 [<CommonParameters>]
<!--NeedCopy-->

DESCRIPTION

FAS can be configured to accept identity assertions from Citrix Cloud Workspace.

This cmdlet creates the Federated Authentication Service (FAS) Cloud configuration by opening a browser for the cloud administrator to authenticate and choose customer and resource location. It is also possible to authenticate silently (i.e. without a browser) using the -SilentAuth flag.

The rule parameter specifies which rule is applied to identity assertions made by Citrix Cloud Workspace.

Once configured with this cmdlet, FAS will attempt to register itself with Citrix Cloud. Use Get-FasCloudConfig to see the status.

EXAMPLES

========================== EXAMPLE 1 ==========================

PS C:\>

C:\PS> $CitrixFasAddress=(Get-FasServer)[0].Address
C:\PS> New-FasCloudConfig
<!--NeedCopy-->

Description

===========

This code creates the FAS cloud configuration.

PARAMETERS

-Rule

Specify the rule applied to identity assertions made by Citrix Cloud Workspace

Type: String
Parameter Sets: (All)
Aliases:

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

-CloudId

Specify the id of the cloud to connect to. Use Get-FasCloudInfo to find supported cloud ids. If not specified, connects to Citrix Cloud.

Type: String
Parameter Sets: (All)
Aliases:

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

-SilentAuth

Use silent authentication

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
<!--NeedCopy-->

-ClientId

Specify the secure client id for silent authentication

Type: String
Parameter Sets: (All)
Aliases:

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

-ClientSecret

Specify the secure client secret for silent authentication

Type: String
Parameter Sets: (All)
Aliases:

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

-Customer

Specify the cloud customer when using silent authentication

Type: String
Parameter Sets: (All)
Aliases:

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

-ResourceLocationId

Specify the resource location id when using silent authentication

Type: String
Parameter Sets: (All)
Aliases:

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

-Address

Specify a particular FAS server to contact (or $NULL to use $CitrixFasAddress)

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: $NULL
Accept pipeline input: False
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: False
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: False
Accept wildcard characters: False
<!--NeedCopy-->

-CwsServiceUri

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
<!--NeedCopy-->

-GeoServiceUri

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
<!--NeedCopy-->

-Staging

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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 nothing

NOTES

Get-FasCloudConfig

Set-FasCloudConfig

Remove-FasCloudConfig

Get-FasCloudInfo

New-FasCloudConfig