New-EntraUser

Sintaxis

Default (valor predeterminado)

New-EntraUser

    -DisplayName <String>
    -AccountEnabled <Boolean>
    -PasswordProfile <PasswordProfile>
    [-City <String>]
    [-UserStateChangedOn <String>]
    [-CompanyName <String>]
    [-PreferredLanguage <String>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Mobile <String>]
    [-UsageLocation <String>]
    [-PostalCode <String>]
    [-AgeGroup <String>]
    [-CreationType <String>]
    [-ConsentProvidedForMinor <String>]
    [-MailNickName <String>]
    [-ImmutableId <String>]
    [-Country <String>]
    [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
    [-Department <String>]
    [-PasswordPolicies <String>]
    [-JobTitle <String>]
    [-UserState <String>]
    [-UserType <String>]
    [-OtherMails <System.Collections.Generic.List`1[System.String]>]
    [-UserPrincipalName <String>]
    [-State <String>]
    [-StreetAddress <String>]
    [-BusinessPhones <String>]
    [-Surname <String>]
    [-ShowInAddressList <Boolean>]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Creación de un usuario mediante el parámetro MailNickName

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
    DisplayName       = 'Avery Iona'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'AveryI@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'averyi'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Avery Iona    AveryI@contoso.com             Member

Ejemplo 2: Creación de un usuario mediante el parámetro AgeGroup

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'

$userParams = @{
    DisplayName       = 'Peyton Davis'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'PeytonD@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'PeytonD'
    AgeGroup          = 'adult'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
bbbbbbbb-1111-2222-3333-cccccccccccc Peyton Davis    PeytonD@contoso.com             Member

Ejemplo 3: Creación de un usuario mediante el parámetro City

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'

$userParams = @{
    DisplayName       = 'Blake Martin'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'BlakeM@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'BlakeM'
    City              = 'New York'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
cccccccc-2222-3333-4444-dddddddddddd Blake Martin    BlakeM@contoso.com             Member

Ejemplo 4: Creación de un usuario mediante el parámetro Department

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
    DisplayName       = 'Parker Jones'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'ParkerJ@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'ParkerJ'
    Department        = 'IT'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
dddddddd-3333-4444-5555-eeeeeeeeeeee Parker Jones    ParkerJ@contoso.com             Member

Ejemplo 5: Creación de un usuario mediante el parámetro Mobile

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'

$UserParams = @{
    DisplayName        = 'Sawyer Miller'
    PasswordProfile    = $passwordProfile
    UserPrincipalName  = 'SawyerM@contoso.com'
    AccountEnabled     = $true
    MailNickName       = 'SawyerM'
    Mobile             = '+18989898989'
}

New-EntraUser @UserParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
eeeeeeee-4444-5555-6666-ffffffffffff Sawyer Miller    SawyerM@contoso.com             Member

Parámetros

-AccountEnabled

Indica si la cuenta del usuario está habilitada.

Propiedades de parámetro

Conjuntos de parámetros

-AgeGroup

Especifica el grupo de edad del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-BusinessPhones

Especifica un número de teléfono.

Propiedades de parámetro

Conjuntos de parámetros

-City

Especifica la ciudad del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-CompanyName

Especifica el nombre de la compañía del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-ConsentProvidedForMinor

Establece si se obtuvo el consentimiento para menores.

Propiedades de parámetro

Conjuntos de parámetros

-Country

Especifica el país del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-CreationType

Indica si la cuenta de usuario es una cuenta local para un inquilino de Microsoft Entra ID B2C. Los valores posibles son "LocalAccount" y null.

• Al crear una cuenta local, se requiere la propiedad y debe establecerla en "LocalAccount".
• Cuando el usuario crea una cuenta profesional o educativa, no especifique la propiedad ni establézcala en null.

Propiedades de parámetro

Conjuntos de parámetros

-Department

Especifica el departamento del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-DisplayName

Especifica el nombre para mostrar del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-FaxNumber

Especifica el número de fax del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-GivenName

Especifica el nombre especificado por el usuario.

Propiedades de parámetro

Conjuntos de parámetros

-ImmutableId

Esta propiedad vincula una cuenta de usuario local a su objeto Microsoft Entra ID y es necesaria al crear un nuevo usuario en Microsoft Graph si el userPrincipalName (UPN) del usuario está en un dominio federado.

Importante: Los caracteres $ y _ no se pueden usar al especificar esta propiedad.

Propiedades de parámetro

Conjuntos de parámetros

-JobTitle

Especifica el título del trabajo del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-MailNickName

Especifica el alias de correo del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-Mobile

Especifica el número de teléfono móvil del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-OtherMails

Una lista de otras direcciones de correo electrónico para el usuario; por ejemplo: "bob@contoso.com", "Robert@fabrikam.com".

Propiedades de parámetro

Conjuntos de parámetros

-PasswordPolicies

Especifica las directivas de contraseña del usuario. Este valor es una enumeración con un valor posible que es "DisableStrongPassword", el cual permite especificar contraseñas menos seguras que la directiva predeterminada. También se puede especificar "DisablePasswordExpiration". Los dos pueden especificarse juntos; por ejemplo: "DisablePasswordExpiration, DisableStrongPassword".

Propiedades de parámetro

Conjuntos de parámetros

-PasswordProfile

Especifica el perfil de contraseña del usuario.

El tipo de parámetro de este parámetro es "PasswordProfile".

Para pasar un parámetro de este tipo, primero debe crear una variable en PowerShell con ese tipo:

$passwordProfile = New-Object -TypeName Microsoft. Open.AzureAD.Model.PasswordProfile

A continuación, puede continuar para establecer el valor de la contraseña en esta variable:

$passwordProfile.Password = "<Password>"

Y, por último, puede pasar esta variable al cmdlet :

New-EntraUser -PasswordProfile $passwordProfile ...

Otros atributos que se pueden establecer en PasswordProfile son

• $passwordProfile.EnforceChangePasswordPolicy: un valor booleano que indica que la directiva de cambio de contraseña está enababled o deshabilitada para este usuario $passwordProfile.

• ForceChangePasswordNextLogin: un valor booleano que indica que el usuario debe cambiar la contraseña en el siguiente inicio de sesión.

Propiedades de parámetro

Conjuntos de parámetros

-PostalCode

Especifica el código postal del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-PreferredLanguage

Especifica el idioma preferido del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-ShowInAddressList

Si es True, muestre este usuario en la lista de direcciones.

Propiedades de parámetro

Conjuntos de parámetros

-SignInNames

Especifica la colección de nombres de inicio de sesión para una cuenta local en un inquilino de Microsoft Entra ID B2C.

Cada nombre de inicio de sesión debe ser único en toda la empresa o inquilino.

La propiedad debe especificarse al crear un usuario de cuenta local; no lo especifique al crear una cuenta profesional o educativa.

Propiedades de parámetro

Conjuntos de parámetros

-State

Especifica el estado del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-StreetAddress

Especifica la dirección postal del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-Surname

Especifica el apellido del usuario.

Propiedades de parámetro

Conjuntos de parámetros

-UsageLocation

Un código de país de dos letras (norma ISO 3166).

Necesario para los usuarios a los que se asignan licencias debido a un requisito legal para comprobar la disponibilidad de los servicios en los países.

Estos son algunos ejemplos: "US", "JP" y "GB".

Propiedades de parámetro

Conjuntos de parámetros

-UserPrincipalName

Nombre principal de usuario (UPN) del usuario.

El UPN es un nombre de inicio de sesión de estilo Internet para el usuario basado en la RFC 822 estándar de Internet.

Por convención, este UPN debe asignarse al nombre de correo electrónico del usuario.

El formato general es "alias@domain".

Para las cuentas profesionales o educativas, el dominio debe estar presente en la colección de dominios comprobados del inquilino.

Esta propiedad es necesaria cuando se crea una cuenta profesional o educativa; es opcional para las cuentas locales.

Propiedades de parámetro

Conjuntos de parámetros

-UserState

Para un usuario externo invitado al inquilino mediante la API de invitación, esta propiedad representa el estado de invitación del usuario invitado.

Propiedades de parámetro

Conjuntos de parámetros

-UserStateChangedOn

Muestra la marca de tiempo del cambio más reciente en la propiedad userState.

Propiedades de parámetro

Conjuntos de parámetros

-UserType

Un valor de cadena puede utilizarse para clasificar los tipos de usuario en el directorio. Por ejemplo: "Miembro" e "Invitado".

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Vínculos relacionados

• Get-EntraUser
• Remove-EntraUser
• Set-EntraUser