Copy-ready commandNew-MgUser
New-MgUser -DisplayName "Jane Smith" -UserPrincipalName jsmith@contoso.com -MailNickname jsmith -AccountEnabled -PasswordProfile $passwordProfileProduction warning
Directory write operations can affect tenant access.
Requirements and permissions
- Requirements
- Microsoft.Graph PowerShell SDK
- Permissions
- Graph delegated or application permissions
- Last reviewed
- 2026-07-31
Examples
Basic example
Create a Microsoft Entra ID user.
New-MgUser -DisplayName "Jane Smith" -UserPrincipalName jsmith@contoso.com -MailNickname jsmith -AccountEnabled -PasswordProfile $passwordProfileCommon errors
Command not found
Confirm Microsoft.Graph PowerShell SDK is installed and available in your current shell.