De Set-EntraDomainFederationSettings cmdlet wordt gebruikt om de instellingen van een domein voor eenmalige aanmelding bij te werken.
Voor gedelegeerde scenario's moet aan de aanroepende gebruiker ten minste een van de volgende Microsoft Entra rollen worden toegewezen:
Beheerder van domeinnamen
Beheerder van de externe identiteitsprovider
Hybrid Identity-beheerder
Beveiligingsbeheerder
Voorbeelden
Voorbeeld 1: PromptLoginBehavior instellen
Connect-Entra -Scopes 'Domain.ReadWrite.All'
$domain = 'contoso.com'
$authProtocol = 'WsFed'
$promptLoginBehavior = 'TranslateToFreshPasswordAuth' # Or 'NativeSupport' or 'Disabled', depending on the requirement
Set-EntraDomainFederationSettings -DomainName $domain -PreferredAuthenticationProtocol $authProtocol -PromptLoginBehavior $promptLoginBehavior
Met deze opdracht wordt de PromptLoginBehavior opdracht bijgewerkt naar TranslateToFreshPasswordAuth, NativeSupportof Disabled. Deze mogelijke waarden worden beschreven:
TranslateToFreshPasswordAuth- betekent het standaardgedrag Microsoft Entra ID van het vertalen naar prompt=loginwauth=https://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/password en wfresh=0.
NativeSupport - betekent dat de prompt=login parameter wordt verzonden zoals is naar ADFS.
Disabled - betekent dat alleen wfresh=0 wordt verzonden naar ADFS
Gebruik de opdracht Get-EntraDomainFederationSettings -DomainName <your_domain_name> | Format-List * om de waarden voor PreferredAuthenticationProtocol en PromptLoginBehavior voor het federatieve domein op te halen.
-DomainName parameter geeft de volledig gekwalificeerde domeinnaam op die moet worden opgehaald.
-PreferredAuthenticationProtocol parameter geeft het voorkeursverificatieprotocol.
-PromptLoginBehavior parameter geeft het aanmeldingsgedrag van de prompt op.
Parameters
-ActiveLogOnUri
Een URL die het eindpunt aangeeft dat door actieve clients wordt gebruikt bij het verifiëren met domeinen die zijn ingesteld voor eenmalige aanmelding (ook wel identiteitsfederatie genoemd) in Microsoft Entra ID.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
6
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-DomainName
De FQDN (Fully Qualified Domain Name) die moet worden bijgewerkt.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
1
Verplicht:
True
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-FederationBrandName
De naam van de tekenreekswaarde die aan gebruikers wordt weergegeven bij het aanmelden bij Microsoft Entra ID.
We raden klanten aan iets te gebruiken dat bekend is voor gebruikers zoals Contoso Inc.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
8
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-IssuerUri
De unieke id van het domein in het Microsoft Entra ID Identity-platform dat is afgeleid van de federatieserver.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
7
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-LogOffUri
De URL-clients worden omgeleid wanneer ze zich afmelden bij Microsoft Entra ID services.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
4
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-MetadataExchangeUri
De URL die het eindpunt voor metagegevensuitwisseling opgeeft dat wordt gebruikt voor verificatie vanuit uitgebreide clienttoepassingen zoals Lync Online.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
9
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-NextSigningCertificate
Het volgende tokenondertekeningscertificaat dat wordt gebruikt om tokens te ondertekenen wanneer het primaire handtekeningcertificaat verloopt.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
3
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-PassiveLogOnUri
De URL waarnaar webclients worden omgeleid bij het aanmelden bij Microsoft Entra ID services.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
5
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-PreferredAuthenticationProtocol
Hiermee geeft u het voorkeursverificatieprotocol.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
10
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-PromptLoginBehavior
Hiermee geeft u het aanmeldingsgedrag van de prompt op.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
12
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-SigningCertificate
Het huidige certificaat dat wordt gebruikt om tokens te ondertekenen die zijn doorgegeven aan het Microsoft Entra ID Identity Platform.
Parametereigenschappen
Type:
System.String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
2
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
-SigningCertificateUpdateStatus
Hiermee geeft u de updatestatus van het handtekeningcertificaat.
Parametereigenschappen
Type:
System.Object
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
11
Verplicht:
False
Waarde uit pijplijn:
True
Waarde uit pijplijn op eigenschapsnaam:
True
Waarde van resterende argumenten:
False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.