Set-AdfsWebConfig
Set-AdfsWebConfig
Modifies web customization configuration settings.
Syntaxe
Parameter Set: Default
Set-AdfsWebConfig [-ActiveThemeName <String> ] [-CDCCookieReader <Uri> ] [-CDCCookieWriter <Uri> ] [-ContextCookieEnabled <Boolean> ] [-HRDCookieEnabled <Boolean> ] [-HRDCookieLifetime <Int32> ] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Description détaillée
The Set-AdfsWebConfig cmdlet modifies web customization configuration settings. These settings impact any protocol that services de fédération Active Directory (AD FS) supports where a web browser facilitates token requests for home realm discovery (HRD) and authentication.
Paramètres
-ActiveThemeName<String>
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.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-CDCCookieReader<Uri>
Specifies the Uniform Resource Identifier (URI) of the Common Domain Cookie (CDC) reader.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-CDCCookieWriter<Uri>
Specifies the URI of the CDC writer.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ContextCookieEnabled<Boolean>
Indicates whether to enable the context cookie.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-HRDCookieEnabled<Boolean>
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.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-HRDCookieLifetime<Int32>
Specifies the lifetime, in days, of an HRD cookie.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
30 |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-PassThru
Retourne un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucun résultat.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Confirm
Votre confirmation sera requise avant l’exécution de l’applet de commande.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-WhatIf
Présente les conséquences éventuelles de l’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.
- System.String;System.String[];System.Uri;System.Int32;System.Boolean
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
- This cmdlet generates string for a theme to save as the active theme.
Exemples
Example 1: Set customization configuration properties
This command sets properties in the web customization configuration settings.
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