New-EntraBetaFeatureRolloutPolicy

管理者がクラウド認証のポリシーを作成して、Microsoft Entra IDでロールアウトできるようにします。

構文

Default (既定)

New-EntraBetaFeatureRolloutPolicy

    -Feature <FeatureEnum>
    -IsEnabled <Boolean>
    [-Description <String>]
    [-IsAppliedToOrganization <Boolean>]
    [-AppliesTo <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.MsDirectoryObject]>]
    -DisplayName <String>
    [<CommonParameters>]

説明

New-EntraBetaFeatureRolloutPolicy コマンドレットを使用すると、管理者はクラウド認証のロールアウト (フェデレーションからクラウド認証に移行するユーザー) のポリシーをMicrosoft Entra IDに作成できます。

ポリシー管理者は、ユーザーが Microsoft Entra ID (パスワード ハッシュ同期) でパスワード ハッシュを使用して認証するか、オンプレミスで直接Microsoft Entra ID (パススルー認証) を使用して認証するかを識別できます。

例 1: Microsoft Entra IDでクラウド認証のロールアウトのポリシーを作成する

Connect-Entra -Scopes 'Directory.ReadWrite.All'
New-EntraBetaFeatureRolloutPolicy -Feature 'PassthroughAuthentication' -DisplayName 'Passthrough Authentication Rollout Policy' -IsEnabled $false

Id                                   Description DisplayName                               Feature                   IsAppliedToOrganization IsEnabled
--                                   ----------- -----------                               -------                   ----------------------- ---------
00aa00aa-bb11-cc22-dd33-44ee44ee44ee            Passthrough Authentication Rollout Policy passthroughAuthentication False                   False

この例では、クラウド認証のポリシーをMicrosoft Entra IDにロールアウトします。

  • -Feature は、クラウド認証ロールアウト ポリシーに割り当てられた機能を指定します。 現在、PassthroughAuthentication | を割り当てることができます。シームレスッソ |PasswordHashSync |EmailAsAlternateId。
  • -DisplayName は、クラウド認証ロールアウト ポリシーの表示名を指定します。
  • -IsEnabled は、クラウド認証のロールアウト ポリシーの状態を指定します。

例 2: クラウド認証のポリシーを作成Microsoft Entra ID

Connect-Entra -Scopes 'Directory.ReadWrite.All'
New-EntraBetaFeatureRolloutPolicy -Feature 'PassthroughAuthentication' -DisplayName 'FeatureRolloutPolicy' -IsEnabled $false -IsAppliedToOrganization $false

Id                                   Description DisplayName          Feature                   IsAppliedToOrganization IsEnabled
--                                   ----------- -----------          -------                   ----------------------- ---------
00aa00aa-bb11-cc22-dd33-44ee44ee44ee           FeatureRolloutPolicy passthroughAuthentication False                   False

このコマンドは、クラウド認証のロールアウトのポリシーをMicrosoft Entra IDに作成します。

  • -Feature は、クラウド認証ロールアウト ポリシーに割り当てられた機能を指定します。 現在、PassthroughAuthentication | を割り当てることができます。シームレスッソ |PasswordHashSync |EmailAsAlternateId。
  • -DisplayName は、クラウド認証ロールアウト ポリシーの表示名を指定します。
  • -IsEnabled は、クラウド認証のロールアウト ポリシーの状態を指定します。
  • -IsAppliedToOrganization は、クラウド認証ロールアウト ポリシーが組織全体に適用されるかどうかを指定します。

パラメーター

-AppliesTo

フィーチャーに割り当てられているMicrosoft Entra IDオブジェクトの一覧を指定します。

パラメーターのプロパティ

型:

System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.MsDirectoryObject]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Description

クラウド認証ロールアウト ポリシーの説明を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DisplayName

クラウド認証ロールアウト ポリシーの表示名を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Feature

クラウド認証ロールアウト ポリシーに割り当てられた機能を指定します。

使用可能な値は次のとおりです。

  • passthroughAuthentication
  • seamlessSso
  • passwordHashSync
  • emailAsAlternateId
  • unknownFutureValue
  • certificateBasedAuthentication
  • multiFactorAuthentication

パラメーターのプロパティ

型:FeatureEnum
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IsAppliedToOrganization

クラウド認証ロールアウト ポリシーが組織全体に適用されるかどうかを指定します。

パラメーターのプロパティ

型:System.Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IsEnabled

クラウド認証ロールアウト ポリシーの状態を指定します。

パラメーターのプロパティ

型:System.Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

出力

Microsoft.Online.Administration.MsFeatureRolloutPolicy

メモ

詳細を表示する - 機能ロールアウト ポリシー