Edit

Share via

Remove-EntraBetaFeatureRolloutPolicyDirectoryObject

Module:
Microsoft.Entra.Beta.SignIns Module v1.1

Allows an admin to remove a group from the cloud authentication rollout policy in Microsoft Entra ID.

Syntax

Default (Default) 

Remove-EntraBetaFeatureRolloutPolicyDirectoryObject

    -DirectoryObjectId <String>
    -FeatureRolloutPolicyId <String>
    [<CommonParameters>]

Description

An admin uses the Remove-EntraBetaFeatureRolloutPolicyDirectoryObject cmdlet to remove groups from the cloud authentication roll-out policy.

Users in these groups start authenticating against the global authentication policy (for example, federation). Specify DirectoryObjectId and FeatureRolloutPolicyId parameter to remove groups from the cloud authentication roll-out policy.

Examples

Example 1: Removes a group from the cloud authentication roll-out policy from Microsoft Entra ID

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$policy = Get-EntraFeatureRolloutPolicy -Filter "displayName eq 'MFA Rollout Policy'"
$group = Get-EntraGroup -Filter "displayName eq 'Sales and Marketing'"
Remove-EntraBetaFeatureRolloutPolicyDirectoryObject -FeatureRolloutPolicyId $policy.Id  -DirectoryObjectId $group.Id

This command removes a group from the cloud authentication roll-out policy from Microsoft Entra ID.

  • -FeatureRolloutPolicyId Parameter specifies the ID of the cloud authentication roll-out policy.
  • -DirectoryObjectId parameter specifies the ID of the specific Microsoft Entra ID directory object that assigned to the cloud authentication roll-out policy.

Parameters

-DirectoryObjectId

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
Aliases:ObjectId

Parameter sets

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

-FeatureRolloutPolicyId

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
Aliases:Id

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.