New-AzureADMSFeatureRolloutPolicy

Reference

Module:: AzureADPreview

Allows an admin to create the policy for cloud authentication roll-out in Azure AD.

Syntax

New-AzureADMSFeatureRolloutPolicy
   -Feature <FeatureEnum>
   -DisplayName <String>
   [-Description <String>]
   -IsEnabled <Boolean>
   [-IsAppliedToOrganization <Boolean>]
   [-AppliesTo <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.MsDirectoryObject]>]
   [<CommonParameters>]

Description

This cmdlet allows an admin to create the policy for cloud authentication roll-out (users moving from federation to cloud auth) in Azure AD. The policy admin can identify whether the users will authenticate using password hashes in Azure AD (Password hash-sync) or Active Directory on-premises directly (Pass-through authentication).

Examples

Example 1: Creates the policy for cloud authentication roll-out in Azure AD.

PS C:\> New-AzureADMSFeatureRolloutPolicy -Feature PassthroughAuthentication -DisplayName "Passthrough Authentication Rollout Policy" -IsEnabled $true

          Feature                 : PassthroughAuthentication
          Id                      : 7ca3e599-e8cc-4d31-9ed6-19dd4f88e833
          DisplayName             : Passthrough Authentication Rollout Policy
          Description             :
          IsEnabled               : True
          IsAppliedToOrganization : False
          AppliesTo               :

This command creates the policy for cloud authentication roll-out in Azure AD.

Parameters

-AppliesTo

Specifies a list of Azure AD objects that is assigned to the feature.

Type:	List<T>[Microsoft.Open.MSGraph.Model.MsDirectoryObject]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Specifies the description of the cloud authentication roll-out policy.

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

-DisplayName

Specifies the display name of the cloud authentication roll-out policy.

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

-Feature

Specifies a feature assigned to the cloud authentication roll-out policy.

Currently, you can assign PassthroughAuthentication | SeamlessSso | PasswordHashSync.

Type:	FeatureEnum
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-IsAppliedToOrganization

Specifies if the cloud authentication roll-out policy applied to the entire organization.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IsEnabled

Specifies the status of cloud authentication roll-out policy.

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Outputs

Microsoft.Online.Administration.MsFeatureRolloutPolicy