Set-AzureADUser
Actualiza un usuario.
Sintaxis
Set-AzureADUser
-ObjectId <String>
[-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
[-AccountEnabled <Boolean>]
[-AgeGroup <String>]
[-City <String>]
[-CompanyName <String>]
[-ConsentProvidedForMinor <String>]
[-Country <String>]
[-CreationType <String>]
[-Department <String>]
[-DisplayName <String>]
[-FacsimileTelephoneNumber <String>]
[-GivenName <String>]
[-IsCompromised <Boolean>]
[-ImmutableId <String>]
[-JobTitle <String>]
[-MailNickName <String>]
[-Mobile <String>]
[-OtherMails <System.Collections.Generic.List`1[System.String]>]
[-PasswordPolicies <String>]
[-PasswordProfile <PasswordProfile>]
[-PhysicalDeliveryOfficeName <String>]
[-PostalCode <String>]
[-PreferredLanguage <String>]
[-ShowInAddressList <Boolean>]
[-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
[-State <String>]
[-StreetAddress <String>]
[-Surname <String>]
[-TelephoneNumber <String>]
[-UsageLocation <String>]
[-UserPrincipalName <String>]
[-UserState <String>]
[-UserStateChangedOn <String>]
[-UserType <String>]
[<CommonParameters>] Description
El cmdlet Set-AzureADUser actualiza un usuario en Azure Active Directory (AD).
Ejemplos
Ejemplo 1: Actualizar un usuario
PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com
PS C:\> $user.DisplayName = 'YetAnotherTestUser'
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.DisplaynameEjemplo 2: Establecer todos los usuarios pero especificados como menores de edad con consentimiento parental
Get-AzureADUser -All $true |
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } |
ForEach-Object { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }Este comando actualiza la propiedad del usuario especificada.
Parámetros
-AccountEnabled
Indica si la cuenta se encuentra habilitada.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-AgeGroup
Se usa en las aplicaciones empresariales para determinar el grupo de edad legal del usuario. Esta propiedad es de solo lectura y se calcula en función de las propiedades ageGroup y consentProvidedForMinor . Valores permitidos: null, notAdultminory adult. Consulte las [definiciones de propiedades del grupo de edad legal][Más información sobre el grupo de edad y las definiciones de consentimiento menores].
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| 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: | False |
| Aceptar caracteres comodín: | False |
-CompanyName
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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ConsentProvidedForMinor
Establece si se ha obtenido el consentimiento para menores. Valores permitidos: null, deniedgrantedy notRequired. Para obtener más información, consulte las [definiciones de propiedades del grupo de edad legal][Más información sobre el grupo de edad y las definiciones de consentimiento menores].
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| 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: | False |
| Aceptar caracteres comodín: | False |
-CreationType
Indica si la cuenta de usuario es una cuenta local para un inquilino de Azure Active Directory B2C. Los valores posibles son "LocalAccount" y NULL. Cuando se crea una cuenta local, la propiedad es obligatoria y debe establecerla en "LocalAccount". Cuando se crea una cuenta profesional o educativa, no especifique la propiedad o establézcala en NULL.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| 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: | False |
| 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: | False |
| Aceptar caracteres comodín: | False |
-ExtensionProperty
Agregue datos a propiedades de usuario personalizadas como extensiones abiertas básicas o las ampliaciones de esquema más versátiles. Consulte [más acerca de las extensiones][Más información sobre las extensiones].
| Tipo: | Dictionary<TKey,TValue>[System.String,System.String] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FacsimileTelephoneNumber
Número de fax del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-GivenName
Especifica el nombre especificado del usuario.
| Tipo: | String |
| 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 del userPrincipalName usuario (UPN).
Importante: Los $ caracteres y _ no se pueden usar al especificar esta propiedad.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-IsCompromised
True si este usuario está en peligro
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-JobTitle
Especifica el puesto del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MailNickName
Especifica un alias para la dirección de correo del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Mobile
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: | False |
| Aceptar caracteres comodín: | False |
-ObjectId
Especifica el identificador de un usuario (como UPN o ObjectId) en Azure AD.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-OtherMails
Especifica otras direcciones de correo electrónico para el usuario.
| Tipo: | List<T>[String] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PasswordPolicies
Especifica directivas de contraseña del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PasswordProfile
Especifica el perfil de contraseña del usuario.
| Tipo: | PasswordProfile |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PhysicalDeliveryOfficeName
La ubicación del lugar de trabajo del usuario. La longitud máxima es de 128 caracteres.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| 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: | False |
| 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: | False |
| Aceptar caracteres comodín: | False |
-ShowInAddressList
Establezca en True para mostrar a este usuario en la lista de direcciones.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SignInNames
Lista de nombres de inicio de sesión para este usuario
| Tipo: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-State
Especifica el estado del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| 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: | False |
| Aceptar caracteres comodín: | False |
-Surname
Especifica el apellido del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-TelephoneNumber
Especifica el número de teléfono del usuario.
| 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 o región de dos letras (norma ISO 3166). Necesario para los usuarios a los que se les asignarán licencias debido a un requisito legal para comprobar la disponibilidad de los servicios en países y regiones. Algunos ejemplos son: "US", "JP" y "GB". No acepta valores NULL.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UserPrincipalName
Especifica el nombre principal de usuario del usuario.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-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. En el caso de los usuarios invitados, el estado puede ser PendingAcceptance o Accepted, o null para todos los demás usuarios.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UserStateChangedOn
Muestra la marca de tiempo para el cambio más reciente a la propiedad externalUserState.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UserType
Un valor de cadena que se puede usar para clasificar tipos de usuario en el directorio, como "Member" y "Guest".
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Notas
Consulte la guía de migración de Set-AzureADUser en Microsoft Graph PowerShell.
Vínculos relacionados
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