Edit

Share via

Add-EntraBetaFeatureRolloutPolicyDirectoryObject

Module:
Microsoft.Entra.Beta Module v1.1

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

Default (Default) 

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.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.