Cómo utilizar New-MgUser para crear usuarios con Microsoft Graph PowerShell

El cmdlet New-MgUser le permite crear nuevos usuarios en Azure Active Directory. Como puede imaginar, hay muchos atributos diferentes que puede configurar al crear un nuevo usuario, y todos ellos se pueden encontrar en la documentación de referencia de Microsoft Graph PowerShell.

En este tutorial, le mostraré cómo crear un nuevo usuario (y varios usuarios nuevos) usando Microsoft Graph PowerShell.

Requisitos previos

Para este tutorial, debe tener instalado el módulo Microsoft Graph PowerShell. Si aún no lo tiene instalado, consulte mi guía sobre Cómo instalar el módulo Microsoft Graph PowerShell. La guía también le explicará cómo actualizar su módulo a la última versión si ha pasado un tiempo desde que lo actualizó.

Acerca del cmdlet New-MgUser

El cmdlet New-MgUser se puede encontrar en el módulo Microsoft.Graph.Users, por lo que para usar el comando, primero se debe importar el módulo a la sesión actual de PowerShell. Esto se puede hacer con el siguiente comando:

Import-Module Microsoft.Graph.Users

También hay muchos permisos diferentes que cubren el uso de este cmdlet, siendo el menos permisivo User.ReadWrite.All.

Puede usar el siguiente comando para ver qué permisos le permiten usar el cmdlet New-MgUser:

(Find-MgGraphCommand -command New-MgUser -apiversion v1.0 | `
select Permissions).permissions

Su salida se verá como la siguiente:

¿Qué atributos se requieren para crear un nuevo usuario?

Al crear una nueva cuenta de usuario en Azure Active Directory (o Microsoft 365), hay una cantidad mínima de información que debe definir para que su solicitud de creación de usuario sea exitosa.

Los siguientes atributos deben definirse siempre cuando se utiliza el cmdlet New-MgUser:

• -DisplayName “Cadena”
• -PasswordProfile @{HashTable}
• -AccountEnabled
• -MailNickName “Cadena”
• -UserPrincipalName “Cadena”

Cómo crear un perfil de contraseña

Una parte importante de la creación de un nuevo usuario es definir la configuración de contraseña que se aplicará. Estas configuraciones de contraseña, como puede ver escrito arriba, se definen dentro de una tabla hash.

Hay 3 configuraciones que puede definir dentro de la tabla hash, de las cuales puede ver un ejemplo a continuación:

$PasswordProfile = @{
  Password = 'Helo123!'
  ForceChangePasswordNextSignIn = $true
  ForceChangePasswordNextSignInWithMfa = $true
}

Contraseña: esta es la contraseña que se asigna al usuario cuando se crea la cuenta. Este es el único par de valores requerido dentro de la tabla hash, lo que significa que las otras configuraciones son opcionales pero recomendadas.

ForceChangePasswordNextSignIn: cuando este valor se establece en $true, la próxima vez que el usuario inicie sesión, se verá obligado a actualizar su contraseña. Si no se especifica esta opción, la configuración predeterminada es $false.

ForceChangePasswordNextSignInWithMfa: esta es la misma configuración que la anterior, sin embargo, esta vez, el usuario se verá obligado a completar el registro de MFA o un desafío antes de que se le solicite que cambie su contraseña. Si no se especifica esta opción, la configuración predeterminada es $false.

Cómo crear un nuevo usuario con Microsoft Graph PowerShell

Para crear su nuevo usuario utilizando el cmdlet New-MgUser, puede copiar el siguiente ejemplo y cambiar la información entre cada cita.

Connect-MgGraph -scope User.ReadWrite.All

New-MgUser -DisplayName ‘New User’ -PasswordProfile $PassProfile `
-AccountEnabled -MailNickName ‘NewUser’ `
-UserPrincipalName '[email ’

Para copiar y pegar el script completo, puede utilizar lo siguiente:

##Import the Microsoft Graph Users module
Import-Module Microsoft.Graph.Users

##Connect to Microsoft Graph with the user read/write permission
Connect-MgGraph -scope User.ReadWrite.All

##Define the password profile settings within a hash table
$PasswordProfile = @{
    Password = "Helo123!"
    ForceChangePasswordNextSignIn = $true
    ForceChangePasswordNextSignInWithMfa = $true
}

##Create the new user account
New-MgUser -DisplayName "New User" -PasswordProfile $PasswordProfile `
-AccountEnabled -MailNickName "NewUser" `
-UserPrincipalName "[email "

Cómo crear múltiples usuarios desde un CSV

A menudo, es posible que necesite crear varias cuentas de usuarios nuevos a la vez. La forma más sencilla de hacerlo es pedirle al departamento de contratación o similar que le proporcione una lista de usuarios con toda la información de usuario deseada en un archivo Excel o CSV.

Puedes usar el archivo CSV de ejemplo que tengo disponible en mi GitHub aquí.

A continuación encontrará el script de ejemplo completo para crear varios usuarios con Microsoft Graph PowerShell desde un CSV.

##Import the Microsoft Graph Users module
Import-Module Microsoft.Graph.Users

##Connect to Microsoft Graph with the user read/write permission
Connect-MgGraph -scope User.ReadWrite.All

##Import csv user list
$newusers = Import-CSV "C:\temp\newusers.csv"

##Define the password profile settings within a hash table
$PasswordProfile = @{
    Password = "Helo123!"
    ForceChangePasswordNextSignIn = $true
    ForceChangePasswordNextSignInWithMfa = $true
}

##Loop through and create each user
ForEach ($user in $newusers){
    New-MgUser -DisplayName $user.displayname `
    -PasswordProfile $PasswordProfile `
    -AccountEnabled `
    -MailNickName $user.mailnickname `
    -UserPrincipalName $user.userprincipalname `
    -Department $user.department `
    -JobTitle $user.jobtitle `
    -Mobile $user.mobile `
    -Birthday $user.birthday `
    -Country $user.country
}

Ahora que has creado tus cuentas de usuario, también puedes echar un vistazo a:

• Cómo asignar licencias de usuario con Microsoft Graph PowerShell
• Cómo utilizar Get-MgUser con Microsoft Graph PowerShell