Set-MsolDomainFederationSettings

  • リファレンス
モジュール:
MSOnline

フェデレーション ドメインの設定を更新します。

構文

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>]

説明

Set-MsolDomainFederationSettings コマンドレットを使用して、シングル サインオン ドメインの設定を更新します。 シングル サインオンは ID フェデレーションとも呼ばれます。

例

例 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 、、NativeSupportまたは DisabledのいずれかにTranslateToFreshPasswordAuth更新します。 これらの使用可能な値を次に示します。

  • TranslateToFreshPasswordAuth: 既定の Azure AD の動作が prompt=login を wauth=https://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/password および wfresh=0 に変換することであることを意味します。
  • NativeSupport: prompt=login パラメーターがそのまま AD FS に送信されることを意味します。
  • 無効: 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
Accept pipeline input:True
Accept wildcard characters:False

-DefaultInteractiveAuthenticationMethod

アプリケーションでユーザーが対話型ログインを行う必要がある場合に使用する既定の認証方法を指定します。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-DomainName

更新する完全修飾ドメイン名 (FQDN) を指定します。

型:String
Position:Named
既定値:None
必須:True
Accept pipeline input:True
Accept wildcard characters:False

-FederationBrandName

Azure Active Directory にサインインするときにユーザーに表示される文字列値の名前を指定します。 Contoso Inc. などの会社名など、ユーザーになじみのあるものを使用することをお勧めします。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-IssuerUri

フェデレーション サーバーから派生した Azure Active Directory ID プラットフォーム内のドメインの URI を指定します。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-LogOffUri

Azure Active Directory サービスからサインアウトするときにクライアントがリダイレクトされる URL を指定します。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-MetadataExchangeUri

Lync Online などのリッチ クライアント アプリケーションからの認証に使用されるメタデータ交換エンドポイントの URL を指定します。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-NextSigningCertificate

プライマリ署名証明書の有効期限が切れたときにトークンの署名に使用する次のトークン署名証明書を指定します。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-OpenIdConnectDiscoveryEndpoint

フェデレーション IDP STS の OpenID Connect 探索エンドポイントを指定します。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-PassiveLogOnUri

Azure Active Directory サービスにサインインするときに Web ベースのクライアントが転送する URL を指定します。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-PreferredAuthenticationProtocol

優先する認証プロトコルを指定します。 有効値は WsFed または Samlp です。

型:AuthenticationProtocol
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-PromptLoginBehavior

プロンプト ログインの動作を指定します。

型:PromptLoginBehavior
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-SigningCertificate

Azure Active Directory ID プラットフォームに渡されるトークンの署名に使用される現在の証明書を指定します。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-SigningCertificateUpdateStatus

署名証明書の更新状態を指定します。

型:SigningCertificateUpdateStatus
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-SupportsMfa

IDP STS が MFA をサポートしているかどうかを示します。

注意

Azure AD リソースをセキュリティ保護するには、条件付きアクセス ポリシーを使用して MFA を要求し、ドメイン設定 SupportsMfa を $True に設定して、ユーザーが 2 段階認証を正常に実行したときに multipleauthn 要求を出力することをお勧めします。

型:Boolean
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

操作を実行するテナントの一意の ID を指定します。 既定値は、現在のユーザーのテナントです。 このパラメーターは、パートナー ユーザーにのみ適用されます。

型:Guid
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False