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
メモ
詳細を表示する - 機能ロールアウト ポリシー