Set-MsolDomainFederationSettings
更新同盟網域的設定。
語法
Set-MsolDomainFederationSettings
-DomainName <String>
[-SigningCertificate <String>]
[-NextSigningCertificate <String>]
[-LogOffUri <String>]
[-PassiveLogOnUri <String>]
[-ActiveLogOnUri <String>]
[-IssuerUri <String>]
[-FederationBrandName <String>]
[-MetadataExchangeUri <String>]
[-PreferredAuthenticationProtocol <AuthenticationProtocol>]
[-SupportsMfa <Boolean>]
[-DefaultInteractiveAuthenticationMethod <String>]
[-OpenIdConnectDiscoveryEndpoint <String>]
[-SigningCertificateUpdateStatus <SigningCertificateUpdateStatus>]
[-PromptLoginBehavior <PromptLoginBehavior>]
[-TenantId <Guid>]
[<CommonParameters>]
Description
Set-MsolDomainFederationSettings Cmdlet 可用來更新單一登錄網域的設定。 單一登錄也稱為身分識別同盟。
範例
範例 1:設定 PromptLoginBehavior
PS C:\> Set-MsolDomainFederationSettings -DomainName <your_domain_name> -PreferredAuthenticationProtocol <your_preferred_authentication_protocol> -SupportsMfa <current_value_for_supportsmfa> -PromptLoginBehavior <TranslateToFreshPasswordAuth|NativeSupport|Disabled>
這個指令會將 PromptLoginBehavior
更新為 TranslateToFreshPasswordAuth
、 NativeSupport
或 Disabled
。 這些可能的值如下所述:
-
TranslateToFreshPasswordAuth:表示轉譯
prompt=login
為wauth=https://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/password
和wfresh=0
的預設 Azure AD 行為。 -
NativeSupport:表示
prompt=login
參數會依原樣傳送至 AD FS。 - Disabled:表示只有 wfresh=0 會傳送至 AD FS
使用取得 Get-MsolDomainFederationSettings -DomainName <your_domain_name> | Format-List *
、 SupportsMfa
和 PromptLoginBehavior
同盟網域的值PreferredAuthenticationProtocol
。
參數
-ActiveLogOnUri
指定在 Azure Active Directory 中針對單一登入設定的網域進行驗證時,作用中用戶端所使用的端點 URL。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-DefaultInteractiveAuthenticationMethod
指定當應用程式要求使用者具有互動式登入時,應該使用的預設驗證方法。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-DomainName
指定要更新 (FQDN) 的完整功能變數名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-FederationBrandName
指定登入 Azure Active Directory 時向用戶顯示的字串值名稱。 建議您使用使用者熟悉的專案,例如公司名稱,例如 Contoso Inc。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-IssuerUri
指定衍生自同盟伺服器之 Azure Active Directory 身分識別平臺中網域的 URI。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-LogOffUri
指定登出 Azure Active Directory 服務時,URL 用戶端會重新導向至 。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-MetadataExchangeUri
指定用於從豐富用戶端應用程式進行驗證的元數據交換端點 URL,例如 Lync Online。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-NextSigningCertificate
指定您在主要簽署憑證到期時用來簽署令牌的下一個令牌簽署憑證。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-OpenIdConnectDiscoveryEndpoint
指定同盟 IDP STS 的 OpenID Connect 探索端點。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-PassiveLogOnUri
指定登入 Azure Active Directory 服務時,Web 型客戶端導向至的 URL。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-PreferredAuthenticationProtocol
指定慣用的驗證通訊協定。 有效值為 WsFed
和 Samlp
。
類型: | AuthenticationProtocol |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-PromptLoginBehavior
指定提示登入行為。
類型: | PromptLoginBehavior |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-SigningCertificate
指定用來簽署傳遞至 Azure Active Directory 身分識別平臺之令牌的目前憑證。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-SigningCertificateUpdateStatus
指定簽署憑證的更新狀態。
類型: | SigningCertificateUpdateStatus |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-SupportsMfa
指出IDP STS是否支援 MFA。
注意
若要保護您的 Azure AD 資源,建議您透過條件式存取原則要求 MFA、將網域設定 SupportsMfa 設定為 $True,並在使用者執行雙步驟驗證成功時發出 multipleauthn 宣告。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-TenantId
指定要在其中執行作業之租使用者的唯一標識符。 預設值為目前使用者的租使用者。 此參數僅適用於合作夥伴使用者。
類型: | Guid |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |