Set-ADFSProxyConfiguration

Sets the configuration properties of the federation server proxy.

Syntax

Set-ADFSProxyConfiguration
   [-HostName <String>]
   [-HttpPort <Int32>]
   [-HttpsPort <Int32>]
   [-LogLevel <String[]>]
   [-ForwardProxyUrl <Uri>]
   [-ProxyTrustRenewPeriod <Int32>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-ADFSProxyConfiguration cmdlet changes the properties of a federation server proxy that has been previously configured.

Examples

-------------------------- EXAMPLE 1 --------------------------

PS C:\>Set-ADFSProxyProperties -Hostname "fs.fabrikam.com"

Sets the properties for the federation server proxy with the name "fs.fabrikam.com".

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForwardProxyUrl

Specifies the URL of a forward proxy to use for communication to the federation service, if any. By default, there is no forward proxy configured.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostName

Specifies the network addressable host name of the Federation Service.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HttpPort

Specifies the HTTP port for the server. The default value is 80.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HttpsPort

Specifies the HTTPS port for the server. The default value is 443.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogLevel

Specifies the level of logging detail. The list defines which types of events are logged.

Possible values are Errors, Warnings, Information, SuccessAudits, and FailureAudits.

Type:String[]
Accepted values:Errors, FailureAudits, Information, Verbose, None, SuccessAudits, Warnings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Passes an object to the pipeline. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyTrustRenewPeriod

Sets the interval (in minutes) that the federation server proxy uses to check with its associated federation server for updated trust tokens.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

None

Notes

  • This cmdlet may be used only on a computer that is configured in Active Directory Federation Services (AD FS) as a federation server proxy. It will not work on a federation server.