Set-AdfsGlobalWebContent

Set-AdfsGlobalWebContent

Sets properties for global web content objects.

Syntaxe

Parameter Set: IdentifierName
Set-AdfsGlobalWebContent [[-Locale] <CultureInfo> ] [-CertificatePageDescriptionText <String> ] [-CompanyName <String> ] [-ErrorPageAuthorizationErrorMessage <String> ] [-ErrorPageDescriptionText <String> ] [-ErrorPageDeviceAuthenticationErrorMessage <String> ] [-ErrorPageGenericErrorMessage <String> ] [-ErrorPageSupportEmail <String> ] [-HelpDeskLink <Uri> ] [-HelpDeskLinkText <String> ] [-HomeLink <Uri> ] [-HomeLinkText <String> ] [-PassThru] [-PrivacyLink <Uri> ] [-PrivacyLinkText <String> ] [-SignInPageAdditionalAuthenticationDescriptionText <String> ] [-SignInPageDescriptionText <String> ] [-SignOutPageDescriptionText <String> ] [-UpdatePasswordPageDescriptionText <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: IdentifierObject
Set-AdfsGlobalWebContent [-TargetWebContent] <AdfsGlobalWebContent> [-CertificatePageDescriptionText <String> ] [-CompanyName <String> ] [-ErrorPageAuthorizationErrorMessage <String> ] [-ErrorPageDescriptionText <String> ] [-ErrorPageDeviceAuthenticationErrorMessage <String> ] [-ErrorPageGenericErrorMessage <String> ] [-ErrorPageSupportEmail <String> ] [-HelpDeskLink <Uri> ] [-HelpDeskLinkText <String> ] [-HomeLink <Uri> ] [-HomeLinkText <String> ] [-PassThru] [-PrivacyLink <Uri> ] [-PrivacyLinkText <String> ] [-SignInPageAdditionalAuthenticationDescriptionText <String> ] [-SignInPageDescriptionText <String> ] [-SignOutPageDescriptionText <String> ] [-UpdatePasswordPageDescriptionText <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Description détaillée

The Set-AdfsGlobalWebContent cmdlet sets properties for a global web content object. Specify a global web object by using a locale, or use the Get-AdfsGlobalWebContent cmdlet to obtain a web object.

Paramètres

-CertificatePageDescriptionText<String>

Specifies the text on the certificate page. services de fédération Active Directory (AD FS) displays the text that you specify when it prompts the user for a certificate. In earlier versions of AD FS, the user sees a blank page when AD FS prompts the user for a certificate.

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

-CompanyName<String>

Specifies the company name. AD FS displays the company name in the sign-in pages when you have not set a logo on the active web theme.

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

-ErrorPageAuthorizationErrorMessage<String>

Specifies an error message to display when a user encounters any authorization errors that occur for a token request. This string can be an HTML fragment. You can override this message for an application by using the Set-AdfsRelyingPartyWebContent 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

-ErrorPageDescriptionText<String>

Specifies an error message to display when a user encounters any generic errors that occur for a token request. This string can be an HTML fragment. You can override this message for an application by using the Set-AdfsRelyingPartyWebContent 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

-ErrorPageDeviceAuthenticationErrorMessage<String>

Specifies an error message to display for any device authentication errors that occur for a token request. Device authentication errors occur when the user presents an expired user@device certificate to AD FS, a certificate is not found in , or a certificate is disabled in . This string can be an HTML fragment. You can override this message for an application by using the Set-AdfsRelyingPartyWebContent 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

-ErrorPageGenericErrorMessage<String>

Specifies an error message to display for any generic errors that occur for a token request. This string can be an HTML fragment. You can override this message for an application by using the Set-AdfsRelyingPartyWebContent 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

-ErrorPageSupportEmail<String>

Specifies the support email address on the error page.

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

-HelpDeskLink<Uri>

Specifies the help desk link that is shown on the logon pages for AD FS.

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

-HelpDeskLinkText<String>

Specifies the help desk link text that is shown on the logon pages for AD FS.

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

-HomeLink<Uri>

Specifies the Home link that is shown on the logon pages for AD FS.

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

-HomeLinkText<String>

Specifies the Home link text that is shown on the logon pages for AD FS.

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

-Locale<CultureInfo>

Specifies a locale. The cmdlet sets global web content for the locale that you specify.

Alias	none
Obligatoire ?	false
Position ?	1
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByValue)
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

-PrivacyLink<Uri>

Specifies the Privacy policy link that is shown on the logon pages for AD FS.

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

-PrivacyLinkText<String>

Specifies the Privacy policy link text that is shown on the logon pages for AD FS.

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

-SignInPageAdditionalAuthenticationDescriptionText<String>

Specifies the description to display when an application prompts a user for additional authentication. The sign-in page can also display a description that is provided by the additional authentication provider.

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

-SignInPageDescriptionText<String>

Specifies the description to display when a user signs in to applications by using AD FS. When you use Integrated Windows Authentication in the intranet, users do not see this page.

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

-SignOutPageDescriptionText<String>

Specifies the description to display when a user signs out of applications.

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

-TargetWebContent<AdfsGlobalWebContent>

Specifies an AdfsGlobalWebContent object. The cmdlet modifies content for the object that you specify. To obtain a AdfsGlobalWebContentobject, use the Get-AdfsGlobalWebContent cmdlet.

Alias	none
Obligatoire ?	true
Position ?	1
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByValue)
Accepter les caractères génériques ?	false

-UpdatePasswordPageDescriptionText<String>

Specifies the description to display in the update password page when users change their passwords.

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.

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

• System.IdentityServer.Management.Resources.AdfsGlobalWebContent

  This cmdlet generates a System.IdentityServer.Management.Resources.AdfsGlobalWebContent object that represents global web content. The object includes the following properties:

  Locale: System.Globalization.CultureInfo
  CompanyName: System.String
  HelpDeskLink: System.Uri
  HelpDeskLinkText: System.String
  HomeLink: System.Uri
  HomeLinkText: System.String
  PrivacyLink: System.Uri
  PrivacyLinkText: System.String
  SignInPageDescriptionText: System.String
  SignOutPageDescriptionText: System.String
  ErrorPageDescriptionText: System.String
  ErrorPageGenericErrorMessage: System.String
  ErrorPageAuthorizationErrorMessage: System.String
  ErrorPageDeviceAuthenticationErrorMessage: System.String
  ErrorPageSupportEmail: System.String
  ErrorPageSupportEmailText: System.String
  UpdatePasswordPageDescriptionText: System.String
  SignInPageAdditionalAuthenticationDescriptionText: System.String

Exemples

Example 1: Set the company name for the global web content

This command sets the company name of the global web content for the invariant locale. If there is no logo, the sign-in page displays the company name Contoso.

PS C:\> Set-AdfsGlobalWebContent -Locale "" -CompanyName "Contoso"

Example 2: Set the text and links for the sign-in pages

This command specifies the text to display in the sign-in pages for AD FS for the en-us locale.

PS C:\> Set-AdfsWebContent -Locale "en-us" -CompanyName "Contoso" -HelpDeskLink "http://helpdesklink" -HelpDeskLinkText "Help desk" -CopyrightText "Copy right" -HomeLink "http://homelink" -HomeLinkText "Home" -PrivacyLink "http://privacylink" -PrivacyLinkText "Privacy statement" -ContactLink "http://contactlink" -ContactLinkText "Contact" -SignInPageDescriptionText "Sign in here" -SignOutPageDescriptionText "Sign out here" -ErrorPageGenericErrorMessage "An error occurred." -ErrorPageSupportEmail "support@contoso.com" -ErrorPageSupportEmailText "Email" -UpdatePasswordPageDescriptionText "Update password here" -UpdatePasswordPageLink "http://updatepasswordlink" -UpdatePasswordPageLinkText "Update password"

Example 3: Set the text and links for the certificate page

This command specifies the text and links to display when an application prompts a user prompted for a certificate.

PS C:\> Set-AdfsGlobalWebContent -Locale "en-us" -CompanyName "Contoso" -HomeLink "http://homelink" -HomeLinkText "Home" -PrivacyLink "http://privaylink" -PrivacyLinkText "Privacy statement" -SignInPageDescriptionText "<p>Sign-in to Contoso requires device registration. Click <A href='http://fs1.contoso.com/deviceregistration/'>here</A> for more information.</p>" -SignOutPageDescriptionText "Sign out here" -ErrorPageGenericErrorMessage "An error occurred." -ErrorPageSupportEmail "support@contoso.com" -UpdatePasswordPageDescriptionText "Update password here" -CertificatePageDescriptionText "Sign in with your Smartcard"

Rubriques connexes

Get-AdfsGlobalWebContent

Remove-AdfsGlobalWebContent

Set-AdfsRelyingPartyWebContent