New-MsolUser
Crea un usuario en Azure Active Directory.
Sintaxis
New-MsolUser
[-ImmutableId <String>]
[-UserPrincipalName <String>]
[-BlockCredential <Boolean>]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DisplayName <String>]
[-Fax <String>]
[-FirstName <String>]
[-LastName <String>]
[-LastPasswordChangeTimestamp <DateTime>]
[-MobilePhone <String>]
[-Office <String>]
[-PasswordNeverExpires <Boolean>]
[-PhoneNumber <String>]
[-PostalCode <String>]
[-PreferredDataLocation <String>]
[-PreferredLanguage <String>]
[-SoftDeletionTimestamp <DateTime>]
[-State <String>]
[-StreetAddress <String>]
[-StrongPasswordRequired <Boolean>]
[-Title <String>]
[-UsageLocation <String>]
[-AlternateEmailAddresses <String[]>]
[-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
[-AlternateMobilePhones <String[]>]
[-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
[-StsRefreshTokensValidFrom <DateTime>]
[-UserType <UserType>]
[-Password <String>]
[-LicenseOptions <LicenseOption[]>]
[-ForceChangePassword <Boolean>]
[-LicenseAssignment <String[]>]
[-TenantId <Guid>]
[<CommonParameters>] Description
El cmdlet New-MsolUser crea un usuario en Azure Active Directory. Para proporcionar al usuario acceso a los servicios, asigne una licencia mediante el parámetro LicenseAssignment .
Ejemplos
Ejemplo 1: crear un usuario
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"Este comando crea un usuario. El usuario no tiene ninguna licencia asignada. Se genera una contraseña aleatoria para el usuario.
Ejemplo 2: Creación de un usuario y asignación de una licencia
Nota
El parámetro -LicenseAssignment está en desuso. Aprenda a asignar licencias con Microsoft Graph PowerShell. Para obtener más información, consulte Assign License Microsoft Graph API (Asignar licencia de Microsoft Graph API).
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"Este comando crea un nuevo usuario y asigna una licencia.
Ejemplo 3: Creación de un usuario y una ubicación de datos preferida
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"Este comando crea un usuario cuyo nombre principal de usuario es jdavidchew@contoso.onmicrosoft.com, el nombre para mostrar es David y la ubicación de datos preferida es EUR.
Parámetros
-AlternateEmailAddresses
Especifica direcciones de correo electrónico alternativas para el usuario.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-AlternateMobilePhones
Especifica números de teléfono móvil alternativos para el usuario.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-BlockCredential
Especifica si el usuario no puede iniciar sesión con su identificador de usuario.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | $false |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-City
Especifica la ciudad del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Country
Especifica el país o región del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Department
Especifica el departamento del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-DisplayName
Especifica el nombre para mostrar del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Fax
Especifica el número de fax del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-FirstName
Especifica el nombre del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ForceChangePassword
Indica que se requiere que el usuario cambie su contraseña la próxima vez que inicie sesión.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | $true |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ImmutableId
Especifica el identificador inmutable de la identidad federada del usuario. Esto se debe omitir para los usuarios con identidades estándar.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-LastName
Especifica el apellido del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-LastPasswordChangeTimestamp
Especifica una hora en la que se cambió por última vez la contraseña.
| Tipo: | DateTime |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-LicenseAssignment
Especifica una matriz de licencias para asignar el usuario.
Nota
El parámetro -LicenseAssignment está en desuso. Aprenda a asignar licencias con Microsoft Graph PowerShell. Para obtener más información, consulte Assign License Microsoft Graph API (Asignar licencia de Microsoft Graph API).
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-LicenseOptions
Especifica las opciones para la asignación de licencias. Se usa para deshabilitar selectivamente los planes de servicio individuales dentro de una SKU.
| Tipo: | LicenseOption[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-MobilePhone
Especifica el número de teléfono móvil del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Office
Especifica la oficina del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Password
Especifica la nueva contraseña para el usuario. Si se establece el usuario para que requiera una contraseña segura, se deben cumplir las siguientes reglas:
- La contraseña debe contener al menos una letra minúscula.
- La contraseña debe contener al menos una letra mayúscula.
- La contraseña debe contener al menos un carácter no alfanumérico.
- La contraseña no puede contener espacios, pestañas ni saltos de línea.
- La longitud de la contraseña debe tener entre 8 y 16 caracteres.
- El nombre de usuario no se puede contener en la contraseña.
Si se omite este valor, se asigna una contraseña aleatoria al usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-PasswordNeverExpires
Especifica si la contraseña de usuario expira periódicamente.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | $false |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-PhoneNumber
Especifica el número de teléfono del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-PostalCode
Especifica el código postal del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-PreferredDataLocation
Especifica la ubicación de datos preferida para el usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-PreferredLanguage
Especifica el idioma preferido del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-SoftDeletionTimestamp
Especifica una hora para la eliminación temporal.
| Tipo: | DateTime |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-State
Especifica el estado o provincia donde se encuentra el usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-StreetAddress
Especifica la dirección postal del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-StrongAuthenticationMethods
Especifica una matriz de métodos de autenticación seguros.
| Tipo: | StrongAuthenticationMethod[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-StrongAuthenticationRequirements
Especifica una matriz de requisitos de autenticación seguros.
| Tipo: | StrongAuthenticationRequirement[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-StrongPasswordRequired
Especifica si se debe requerir una contraseña segura para el usuario.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | $true |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-StsRefreshTokensValidFrom
Especifica un valor StsRefreshTokensValidFrom.
| Tipo: | DateTime |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-TenantId
Especifica el identificador único del inquilino en el que se va a realizar la operación. El valor predeterminado es el inquilino del usuario actual. Este parámetro solo se aplica a los usuarios asociados.
| Tipo: | Guid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Title
Especifica el título del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-UsageLocation
Especifica la ubicación del usuario donde se consumen los servicios. Especifique un código de país o región de dos letras.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-UserPrincipalName
Especifica el identificador de usuario para este usuario. Este es un paso necesario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-UserType
Especifica el tipo de usuario.
| Tipo: | UserType |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
Salidas
Microsoft.Online.Administration.User
Este cmdlet devuelve detalles sobre el nuevo usuario que se creó, incluida su contraseña temporal.