Edit

Share via

Add-EntraBetaFeatureRolloutPolicyDirectoryObject

  • Reference
Module:
Microsoft.Entra.Beta

Allows an admin to add a group to the cloud authentication roll-out policy in Microsoft Entra ID. Users in this group start authenticating to the cloud per policy.

Syntax

Add-EntraBetaFeatureRolloutPolicyDirectoryObject
   -Id <String>
   -RefObjectId <String>
   [<CommonParameters>]

Description

An admin uses Add-EntraBetaFeatureRolloutPolicyDirectoryObject cmdlet to add a group to the cloud authentication roll-out policy. Users in these groups start authenticating against the cloud per policy (for example, with Seamless single sign-on or not, or whether Passthrough auth or not). Specify Id and RefObjectId parameter to add a group to the cloud authentication roll-out policy.

Examples

Example 1: Adds a group to the cloud authentication roll-out policy in Microsoft Entra ID

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$params = @{
    Id = '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'
    RefObjectId = 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
}
Add-EntraBetaFeatureRolloutPolicyDirectoryObject @params

This command adds a group to the cloud authentication roll-out policy in Microsoft Entra ID.

  • -Id Parameter specifies the ID of the cloud authentication roll-out policy.
  • -RefObjectId Parameter specifies the ID of the specific Microsoft Entra ID object that assigned to the cloud authentication roll-out policy.

Parameters

-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

-RefObjectId

The unique identifier of the specific Microsoft Entra ID object that assigned to 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