New-AzADUser
Agrega una nueva entidad a los usuarios
Syntax
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 $upnCreació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 $upnCreació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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AccountEnabled
true para habilitar la cuenta; de lo contrario, false.
| Type: | Boolean |
| Aliases: | EnableAccount |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
| Type: | PSObject |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeletedDateTime
.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceEnrollmentLimit
Límite en el número máximo de dispositivos que el usuario puede inscribir. Los valores permitidos son 5 o 1000.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EmployeeId
Identificador de empleado asignado al usuario por la organización. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EmployeeType
Captura el tipo de trabajo empresarial. Por ejemplo, Empleado, Contratista, Consultor o Proveedor. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExternalUserStateChangeDateTime
Muestra la marca de tiempo para el cambio más reciente a la propiedad externalUserState. Admite $filter (eq, ne, NOT , in).
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FaxNumber
Número de fax del usuario. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GivenName
EL nombre del usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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)..
| Type: | String |
| Aliases: | OnPremisesImmutableId |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Interest
Lista para que el usuario describa sus intereses. Se devuelve solo en $select.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsResourceAccount
No usar: reservado para uso futuro.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobTitle
El puesto del usuario. La longitud máxima es de 128 caracteres. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MySite
Dirección URL del sitio personal del usuario. Se devuelve solo en $select.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SecureString |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PasswordProfile
passwordProfile Para construir, consulte la sección NOTES para las propiedades PASSWORDPROFILE y crear una tabla hash.
| Type: | IMicrosoftGraphPasswordProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PreferredName
Nombre preferido para el usuario. Se devuelve solo en $select.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Responsibility
Lista para que el usuario enumere sus responsabilidades. Se devuelve solo en $select.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-School
Lista para que el usuario enumere las escuelas a las que ha asistido. Se devuelve solo en $select.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Skill
Lista para que el usuario enumere sus aptitudes. Se devuelve solo en $select.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Surname
Los apellidos del usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Salidas
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.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de