Set-Adfs Web Config

Module:
adfs
Modifies web customization configuration settings.

Syntax 

Set-AdfsWebConfig
   [-ActiveThemeName <String>]
   [-CDCCookieReader <Uri>]
   [-CDCCookieWriter <Uri>]
   [-HRDCookieLifetime <Int32>]
   [-HRDCookieEnabled <Boolean>]
   [-ContextCookieEnabled <Boolean>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-AdfsWebConfig cmdlet modifies web customization configuration settings. These settings impact any protocol that Active Directory Federation Services (AD FS) supports where a web browser facilitates token requests for home realm discovery (HRD) and authentication.

Examples

Example 1: Set customization configuration properties 

PS C:\> Set-AdfsWebConfig -ActiveThemeName "Default" -CDCCookieReader https://www.Contoso.com/reader.aspx -CDCCookieWriter https://www.Contoso.com/writer.aspx -ContextCookieEnabled $True -HRDCookieEnabled $True -HRDCookieLifetime 30

ActiveThemeName      : Default

CDCCookieReader      :

CDCCookieWriter      :

HRDCookieLifetime    : 30

HRDCookieEnabled     : True

ContextCookieEnabled : True

This command sets properties in the web customization configuration settings.

Optional Parameters

-ActiveThemeName

Specifies the name of a web theme to be set as the active web theme in the web customization configuration. To create a web theme, use the New-AdfsWebTheme cmdlet.

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

Specifies the Uniform Resource Identifier (URI) of the Common Domain Cookie (CDC) reader.

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

Specifies the URI of the CDC writer.

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

Prompts you for confirmation before running the cmdlet.

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

Indicates whether to enable the context cookie.

Type: Boolean
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HRDCookieEnabled

Indicates whether to enable the HRD cookie. If you specify a value of $False, when AD FS has more than one claims provider trust enabled, end users must select the home realm in every application request.

Type: Boolean
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HRDCookieLifetime

Specifies the lifetime, in days, of an HRD cookie.

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

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type: SwitchParameter
Position: Named
Default value: None
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
Accept pipeline input: False
Accept wildcard characters: False

Inputs

System.String;System.String[];System.Uri;System.Int32;System.Boolean

Outputs

This cmdlet generates string for a theme to save as the active theme.