New-AzADUser

Módulo:

Az.Resources

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 = ConvertTo-SecureString -String "****" -AsPlainText -Force
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

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

Nombre de la compañía 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 pide 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

Las credenciales, la cuenta, el inquilino y la suscripción que se usan 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

Nombre del departamento en el que funciona 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

Nombre especificado (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 de 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

Título del 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

-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

Alias de correo para el 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

Número de teléfono móvil principal para el 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

Ubicación de la oficina en el lugar de negocio 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 postal del usuario. El código postal es específico del país o región del usuario. En Estados Unidos de América, este atributo contiene el código postal. 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

Idioma preferido para el 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

Estado o provincia en 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

Dirección postal del lugar de negocio 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

Apellido del usuario (nombre de familia o apellido). 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

Código de país de dos letras (norma ISO 3166). Necesario para los usuarios a los que se asignarán licencias debido a un requisito legal para 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

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 el RFC 822 estándar de Internet. 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 el cmdlet se ejecuta. 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