New-AzADUser: Following documentation leads to "constructor not found" issue

[CallumCrowley]

Description

Issue

The documentation here states that you must construct a password profile object using the type:

Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile

However, despite importing both Az.Accounts and Az.Resources, this will result in an error:

Error: A constructor was not found. Cannot find an appropriate constructor for type Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile.

Issue script & Debug output

$passwordProfile = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile" -Property @{
                Password = $user.Password
                ForceChangePasswordNextSignIn = $false
                ForceChangePasswordNextSignInWithMfa = $false
            }

New-AzADUser -DisplayName $user.Name -PasswordProfile $passwordProfile -AccountEnabled $true -MailNickname $mailNickname -Mail $emailAddress -UserPrincipalName $upn -OtherMail $otherMail

Environment data

Name                           Value                                                                                                                                                          
----                           -----                                                                                                                                                          
PSVersion                      5.1.22000.653                                                                                                                                                  
PSEdition                      Desktop                                                                                                                                                        
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}                                                                                                                                        
BuildVersion                   10.0.22000.653                                                                                                                                                 
CLRVersion                     4.0.30319.42000                                                                                                                                                
WSManStackVersion              3.0                                                                                                                                                            
PSRemotingProtocolVersion      2.3                                                                                                                                                            
SerializationVersion           1.1.0.1

Module versions

ModuleType Version    Name                                ExportedCommands                                                                                                                    
---------- -------    ----                                ----------------                                                                                                                    
Script     2.9.1      Az.Accounts                         {Add-AzEnvironment, Clear-AzConfig, Clear-AzContext, Clear-AzDefault...}                                                            
Script     6.1.0      Az.Resources                        {Export-AzResourceGroup, Export-AzTemplateSpec, Get-AzDenyAssignment, Get-AzDeployment...}

Error output

A constructor was not found. Cannot find an appropriate constructor for type Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile.

[dingmeng-xue]

@CallumCrowley , Thanks for reporting. It is an issue in doc. IMicrosoftGraphPasswordProfile is interface. You should use MicrosoftGraphPasswordProfile. We need to fix this doc soon.

$passwordProfile = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.MicrosoftGraphPasswordProfile" -Property @{
  Password = $user.Password
  ForceChangePasswordNextSignIn = $false
  ForceChangePasswordNextSignInWithMfa = $false
}

[CallumCrowley]

@dingmeng-xue yes, I actually tried this but I found that the New-AzADUser cmdlet would then ignore the PasswordProfile parameter and demand that the Password parameter be completed.

Can you confirm if there is an issue using the PasswordProfile parameter with this cmdlet?

[VeryEarly]

@dingmeng-xue yes, I actually tried this but I found that the New-AzADUser cmdlet would then ignore the PasswordProfile parameter and demand that the Password parameter be completed.

Can you confirm if there is an issue using the PasswordProfile parameter with this cmdlet?

Hi @CallumCrowley ,

Thanks for pointing out, currently "-Password" will overwrite and ignore "-PasswordProfile", I'll make the fix soon in 2022-09-06-release

[CallumCrowley]

@VeryEarly thanks for confirming! 😄