Edit

Share via

Get-EntraBetaFeatureRolloutPolicy

  • Reference
Module:
Microsoft.Entra.Beta

Gets the policy for cloud authentication roll-out in Microsoft Entra ID.

Syntax

Get-EntraBetaFeatureRolloutPolicy
   [-Filter <String>]
   [-Property <String[]>]
   [<CommonParameters>]
Get-EntraBetaFeatureRolloutPolicy
   [-SearchString <String>]
   [-Property <String[]>]
   [<CommonParameters>]
Get-EntraBetaFeatureRolloutPolicy
   -Id <String>
   [-Property <String[]>]
   [<CommonParameters>]

Description

The Get-EntraBetaFeatureRolloutPolicy cmdlet allows an admin to get the policy for cloud authentication rollout (users moving from federation to cloud auth) in Microsoft Entra ID. This policy consists of one or two FeatureRolloutPolicy objects. These objects hold the groups assigned for cloud authentication (Pass-through authentication or Password Hash Sync) and groups assigned for Seamless single sign-on.

Examples

Example 1: Retrieves a list of all cloud authentication roll-out in Microsoft Entra ID

Connect-Entra -Scopes 'Directory.ReadWrite.All'
Get-EntraBetaFeatureRolloutPolicy

Id                                   Description            DisplayName                Feature            IsAppliedToOrganization IsEnabled
--                                   -----------            -----------                -------            ----------------------- ---------
00aa00aa-bb11-cc22-dd33-44ee44ee44ee Feature-Rollout-test   Feature-Rollout-Policytest passwordHashSync   False                   True
11bb11bb-cc22-dd33-ee44-55ff55ff55ff Feature-Rollout-Policy change                     emailAsAlternateId False                   False

This command retrieves a list of all cloud authentication roll-out policies in Microsoft Entra ID.

Example 2: Retrieves cloud authentication roll-out in Microsoft Entra ID with given ID

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$policy = Get-EntraBetaFeatureRolloutPolicy -Filter "DisplayName eq 'FeatureRolloutPolicy'"
Get-EntraBetaFeatureRolloutPolicy -Id $policy.Id

Id                                   Description          DisplayName                Feature          IsAppliedToOrganization IsEnabled
--                                   -----------          -----------                -------          ----------------------- ---------
11bb11bb-cc22-dd33-ee44-55ff55ff55ff Feature-Rollout-test Feature-Rollout-Policytest passwordHashSync False                   True

This example retrieves the policy for cloud authentication roll-out policy in Microsoft Entra ID.

  • -Id - Specify The unique identifier of the cloud authentication roll-out policy in Microsoft Entra ID.

Example 3: Retrieves cloud authentication roll-out in Microsoft Entra ID with given Search String

Connect-Entra -Scopes 'Directory.ReadWrite.All'
Get-EntraBetaFeatureRolloutPolicy -SearchString 'Feature-Rollout-Policytest'

Id                                   Description          DisplayName                Feature          IsAppliedToOrganization IsEnabled
--                                   -----------          -----------                -------          ----------------------- ---------
11bb11bb-cc22-dd33-ee44-55ff55ff55ff Feature-Rollout-test Feature-Rollout-Policytest passwordHashSync False

This command retrieves the policy for cloud authentication roll-out policy in Microsoft Entra ID.

Example 4: Retrieves cloud authentication roll-out in Microsoft Entra ID with given Filter parameter

Connect-Entra -Scopes 'Directory.ReadWrite.All'
Get-EntraBetaFeatureRolloutPolicy -Filter "DisplayName eq 'Feature-Rollout-Policytest'"

Id                                   Description          DisplayName                Feature          IsAppliedToOrganization IsEnabled
--                                   -----------          -----------                -------          ----------------------- ---------
11bb11bb-cc22-dd33-ee44-55ff55ff55ff Feature-Rollout-test Feature-Rollout-Policytest passwordHashSync False

This command retrieves the policy for cloud authentication roll-out policy in Microsoft Entra ID.

Parameters

-Filter

Specifies an OData v4.0 filter statement. Controls which objects are returned.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

The unique identifier of the cloud authentication roll-out policy in Microsoft Entra ID.

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Property

Specifies properties to be returned.

Type:System.String[]
Aliases:Select
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchString

Specifies a search string.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Outputs

Microsoft.Online.Administration.MsFeatureRolloutPolicy