Compartir a través de


New-AzADUser

Agrega una nueva entidad a los usuarios

Sintaxis

New-AzADUser
   -DisplayName <String>
   -MailNickname <String>
   -UserPrincipalName <String>
   -Password <SecureString>
   [-AboutMe <String>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-Birthday <DateTime>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-DeletedDateTime <DateTime>]
   [-Department <String>]
   [-DeviceEnrollmentLimit <Int32>]
   [-EmployeeHireDate <DateTime>]
   [-EmployeeId <String>]
   [-EmployeeType <String>]
   [-ExternalUserState <String>]
   [-ExternalUserStateChangeDateTime <DateTime>]
   [-FaxNumber <String>]
   [-GivenName <String>]
   [-HireDate <DateTime>]
   [-Interest <String[]>]
   [-IsResourceAccount]
   [-JobTitle <String>]
   [-Mail <String>]
   [-MobilePhone <String>]
   [-MySite <String>]
   [-OfficeLocation <String>]
   [-ImmutableId <String>]
   [-OtherMail <String[]>]
   [-PasswordPolicy <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-PreferredName <String>]
   [-Responsibility <String[]>]
   [-School <String[]>]
   [-ShowInAddressList]
   [-Skill <String[]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-UsageLocation <String>]
   [-UserType <String>]
   [-ForceChangePasswordNextLogin]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzADUser
   -DisplayName <String>
   -MailNickname <String>
   -UserPrincipalName <String>
   [-AboutMe <String>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-Birthday <DateTime>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-DeletedDateTime <DateTime>]
   [-Department <String>]
   [-DeviceEnrollmentLimit <Int32>]
   [-EmployeeHireDate <DateTime>]
   [-EmployeeId <String>]
   [-EmployeeType <String>]
   [-ExternalUserState <String>]
   [-ExternalUserStateChangeDateTime <DateTime>]
   [-FaxNumber <String>]
   [-GivenName <String>]
   [-HireDate <DateTime>]
   [-Interest <String[]>]
   [-IsResourceAccount]
   [-JobTitle <String>]
   [-Mail <String>]
   [-MobilePhone <String>]
   [-MySite <String>]
   [-OfficeLocation <String>]
   [-ImmutableId <String>]
   [-OtherMail <String[]>]
   [-PasswordPolicy <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-PreferredName <String>]
   [-Responsibility <String[]>]
   [-School <String[]>]
   [-ShowInAddressList]
   [-Skill <String[]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-UsageLocation <String>]
   [-UserType <String>]
   -PasswordProfile <IMicrosoftGraphPasswordProfile>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Agrega una nueva entidad a los usuarios

Ejemplos

Ejemplo 1: Creación de un usuario con perfil de contraseña

$password = "xxxxxxxxxx"
$pp = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile" -Property @{Password=$password}
New-AzADUser -DisplayName $uname -PasswordProfile $pp -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Creación de un usuario con perfil de contraseña

Ejemplo 2: Creación de un usuario con contraseña

$password = "xxxxxxxxxx"
$password = ConvertTo-SecureString -AsPlainText -Force $password
New-AzADUser -DisplayName $uname -Password $password -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Creación de un usuario con contraseña

Parámetros

-AboutMe

Campo de entrada de texto de forma libre para que el usuario se describa por sí mismo. Se devuelve solo en $select.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AccountEnabled

true para habilitar la cuenta; de lo contrario, false.

Tipo:Boolean
Alias:EnableAccount
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AgeGroup

Establece el grupo de edad del usuario. Valores permitidos: null, minor, notAdult y adult. Consulte las definiciones de propiedades del grupo de edad legal para obtener más información. Admite $filter (eq, ne, NOT y in).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Birthday

El cumpleaños del usuario. El tipo timestamp representa información de fecha y hora con el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, medianoche UTC el 1 de enero de 2014 es 2014-01-01T00:00:00Z Devuelto solo en $select.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-City

La ciudad en la que se encuentra el usuario. La longitud máxima es de 128 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CompanyName

el nombre de la empresa al que está asociado el usuario. Esta propiedad puede ser útil para describir la empresa de la que procede un usuario externo. La longitud máxima del nombre de la empresa es de 64 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ConsentProvidedForMinor

Establece si el consentimiento se ha obtenido para menores. Valores permitidos: null, concedidos, denegados y notRequired. Consulte las definiciones de propiedades del grupo de edad legal para obtener más información. Admite $filter (eq, ne, NOT y in).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Country

País o región en el que se encuentra el usuario; por ejemplo, Estados Unidos o Reino Unido. La longitud máxima es de 128 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:PSObject
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeletedDateTime

.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Department

El nombre del departamento en el que trabaja el usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT , ge, le y en operadores).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeviceEnrollmentLimit

Límite en el número máximo de dispositivos que el usuario puede inscribir. Los valores permitidos son 5 o 1000.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplayName

Nombre que se muestra en la libreta de direcciones para el usuario. Este valor suele ser la combinación del nombre del usuario, la inicial intermedia y el apellido. Esta propiedad es necesaria cuando se crea un usuario y no se puede borrar durante las actualizaciones. La longitud máxima es de 256 caracteres. Admite $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBy y $search.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EmployeeHireDate

Fecha y hora en que se contrató al usuario o empezará a trabajar en caso de contratación futura. Admite $filter (eq, ne, NOT , ge, le, in).

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EmployeeId

Identificador de empleado asignado al usuario por la organización. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EmployeeType

Captura el tipo de trabajo empresarial. Por ejemplo, Empleado, Contratista, Consultor o Proveedor. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExternalUserState

Para un usuario externo invitado al inquilino mediante la API de invitación, esta propiedad representa el estado de invitación del usuario invitado. Para los usuarios invitados, el estado puede ser PendingAcceptance o Accepted, o null para todos los demás usuarios. Admite $filter (eq, ne, NOT , in).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExternalUserStateChangeDateTime

Muestra la marca de tiempo para el cambio más reciente a la propiedad externalUserState. Admite $filter (eq, ne, NOT , in).

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FaxNumber

Número de fax del usuario. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceChangePasswordNextLogin

Debe especificarse si el usuario debe cambiar la contraseña en el siguiente inicio de sesión correcto (true). El comportamiento predeterminado es (false) para no cambiar la contraseña en el siguiente inicio de sesión correcto.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GivenName

EL nombre del usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HireDate

Fecha de contratación del usuario. El tipo timestamp representa información de fecha y hora con el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, medianoche UTC el 1 de enero de 2014 es 2014-01-01T00:00:00Z. Se devuelve solo en $select. Nota: Esta propiedad es específica de SharePoint Online. Se recomienda usar la propiedad employeeHireDate nativa para establecer y actualizar los valores de fecha de contratación mediante las API de Microsoft Graph.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ImmutableId

Esta propiedad se usa para asociar una cuenta de usuario Active Directory local a su objeto de usuario de Azure AD. Esta propiedad debe especificarse al crear una nueva cuenta de usuario en Graph si usa un dominio federado para la propiedad userPrincipalName (UPN) del usuario. NOTA: Los caracteres $ y _ no se pueden usar al especificar esta propiedad. Se devuelve solo en $select. Admite $filter (eq, ne, NOT, ge, le, in)..

Tipo:String
Alias:OnPremisesImmutableId
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Interest

Lista para que el usuario describa sus intereses. Se devuelve solo en $select.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsResourceAccount

No usar: reservado para uso futuro.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobTitle

El puesto del usuario. La longitud máxima es de 128 caracteres. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Mail

La dirección SMTP del usuario, por ejemplo, admin@contoso.com. Los cambios en esta propiedad también actualizarán la colección proxyAddresses del usuario para incluir el valor como una dirección SMTP. Aunque esta propiedad puede contener caracteres de énfasis, su uso puede provocar problemas de acceso con otras aplicaciones de Microsoft para el usuario. Admite $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MailNickname

El alias de correo electrónico del usuario. Esta propiedad debe especificarse cuando se crea un usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MobilePhone

EL número de teléfono móvil principal del usuario. Solo lectura para los usuarios sincronizados desde el directorio local. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MySite

Dirección URL del sitio personal del usuario. Se devuelve solo en $select.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OfficeLocation

La ubicación del lugar de trabajo del usuario. La longitud máxima es de 128 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OtherMail

Lista de direcciones de correo electrónico adicionales para el usuario; por ejemplo: [''bob@contoso.com, 'Robert@fabrikam.com']. NOTA: Aunque esta propiedad puede contener caracteres de énfasis, pueden provocar problemas de acceso a aplicaciones propias para el usuario. Admite $filter (eq, NOT, ge, le, in, startsWith).

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Password

Contraseña del usuario. Debe cumplir los requisitos de complejidad de la contraseña del inquilino. Se recomienda establecer una contraseña segura.

Tipo:SecureString
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PasswordPolicy

Especifica directivas de contraseña para el usuario. Este valor es una enumeración con un valor posible que es DisableStrongPassword, que permite especificar contraseñas más débiles que la directiva predeterminada. También se puede especificar DisablePasswordExpiration. Los dos pueden especificarse juntos; por ejemplo: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PasswordProfile

passwordProfile Para construir, consulte la sección NOTES para las propiedades PASSWORDPROFILE y crear una tabla hash.

Tipo:IMicrosoftGraphPasswordProfile
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PostalCode

El código postal de la dirección del usuario. El código postal es específico del país o la región del usuario. En Estados Unidos de América, este atributo contiene el código ZIP. La longitud máxima es de 40 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PreferredLanguage

El idioma preferido del usuario. Debe seguir el código ISO 639-1; por ejemplo, en-US. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PreferredName

Nombre preferido para el usuario. Se devuelve solo en $select.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Responsibility

Lista para que el usuario enumere sus responsabilidades. Se devuelve solo en $select.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-School

Lista para que el usuario enumere las escuelas a las que ha asistido. Se devuelve solo en $select.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ShowInAddressList

True si la lista de direcciones globales de Outlook debe contener este usuario; de lo contrario, false. Si no se establece, se tratará como true. Para los usuarios invitados a través del administrador de invitaciones, esta propiedad se establecerá en false. Admite $filter (eq, ne, NOT, in).

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Skill

Lista para que el usuario enumere sus aptitudes. Se devuelve solo en $select.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-State

El estado o provincia de la dirección del usuario. La longitud máxima es de 128 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-StreetAddress

La dirección postal del lugar de trabajo del usuario. La longitud máxima es de 1024 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Surname

Los apellidos del usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UsageLocation

Un código de país o región de dos letras (norma ISO 3166). Es necesario para los usuarios a los que se asignarán licencias debido al requisito legal de comprobar la disponibilidad de los servicios en los países. Algunos ejemplos son: US, JP y GB. No acepta valores NULL. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserPrincipalName

El nombre principal de usuario (UPN) del usuario. El UPN es un nombre de inicio de sesión del estilo de Internet del usuario basado en el estándar de Internet RFC 822. Por convención, esto debe asignarse al nombre de correo electrónico del usuario. El formato general es alias@domain, donde el dominio debe estar presente en la colección de dominios comprobados del inquilino. Esta propiedad es necesaria cuando se crea un usuario. Se puede acceder a los dominios comprobados del inquilino desde la propiedad verifiedDomains de la organización. NOTA: Aunque esta propiedad puede contener caracteres de énfasis, pueden provocar problemas de acceso a aplicaciones propias para el usuario. Admite $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) y $orderBy.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserType

Valor de cadena que se puede usar para clasificar los tipos de usuario en el directorio, como Miembro e Invitado. Admite $filter (eq, ne, NOT, in).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

IMicrosoftGraphUser

Notas

ALIAS

PROPIEDADES DE PARÁMETRO COMPLEJAS

Para crear los parámetros descritos a continuación, cree una tabla hash que contenga las propiedades adecuadas. Para obtener información sobre las tablas hash, ejecute Get-Help about_Hash_Tables.

PASSWORDPROFILE <IMicrosoftGraphPasswordProfile>: passwordProfile

  • [(Any) <Object>]: indica que se puede agregar cualquier propiedad a este objeto.
  • [ForceChangePasswordNextSignIn <Boolean?>]: true si el usuario debe cambiar su contraseña en el siguiente inicio de sesión; de lo contrario, false. Si no se establece, el valor predeterminado es false. NOTA: Para los inquilinos de Azure B2C, establezca en false y, en su lugar, use directivas personalizadas y flujos de usuario para forzar el restablecimiento de contraseña en el primer inicio de sesión. Consulte Forzar el restablecimiento de contraseña en el primer inicio de sesión.
  • [ForceChangePasswordNextSignInWithMfa <Boolean?>]: si es true, en el siguiente inicio de sesión, el usuario debe realizar una autenticación multifactor (MFA) antes de forzarse a cambiar su contraseña. El comportamiento es idéntico a forceChangePasswordNextSignIn, excepto que el usuario debe realizar primero una autenticación multifactor antes de cambiar la contraseña. Después de un cambio de contraseña, esta propiedad se restablecerá automáticamente a false. Si no se establece, el valor predeterminado es false.
  • [Password <String>]: la contraseña del usuario. Esta propiedad es necesaria cuando se crea un usuario. Se puede actualizar, pero se le pedirá al usuario que cambie la contraseña en el siguiente inicio de sesión. La contraseña debe cumplir los requisitos mínimos especificados por la propiedad passwordPolicies del usuario. De forma predeterminada, se requiere una contraseña segura.