Set-AzureADUser

Actualiza un usuario.

Syntax

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.Displayname

Ejemplo 2: Establecer todos los usuarios pero especificados como menores 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 especificado.

Parámetros

-AccountEnabled

Indica si la cuenta se encuentra habilitada.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AgeGroup

Lo usan 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 de grupo de edad legal][Más información sobre el grupo de edad y las definiciones de consentimiento menores].

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-City

Especifica la ciudad del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ConsentProvidedForMinor

Establece si se ha obtenido el consentimiento para menores. Valores permitidos: null, deniedgrantedy notRequired. Consulte las [definiciones de propiedades de grupo de edad legal][Más información sobre el grupo de edad y las definiciones de consentimiento menores] para obtener más información.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Country

Especifica el país del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Department

Especifica el departamento del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Especifica el nombre para mostrar del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ExtensionProperty

Agregue datos a propiedades de usuario personalizadas como extensiones abiertas básicas o las extensaciones de esquema más versátiles. Consulte [más acerca de las extensiones][Más información sobre las extensiones].

Type:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FacsimileTelephoneNumber

Número de fax del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-GivenName

Especifica el nombre especificado del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IsCompromised

True si este usuario está en peligro

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-JobTitle

Especifica el puesto del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MailNickName

Especifica un alias para la dirección de correo del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Mobile

Especifica el número de teléfono móvil del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Especifica el identificador de un usuario (como UPN o ObjectId) en Azure AD.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-OtherMails

Especifica otras direcciones de correo electrónico para el usuario.

Type:List<T>[String]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PasswordPolicies

Especifica directivas de contraseña del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PasswordProfile

Especifica el perfil de contraseña del usuario.

Type:PasswordProfile
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalDeliveryOfficeName

La ubicación del lugar de trabajo del usuario. La longitud máxima es de 128 caracteres.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PostalCode

Especifica el código postal del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PreferredLanguage

Especifica el idioma preferido del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ShowInAddressList

Establezca en True para mostrar a este usuario en la lista de direcciones.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SignInNames

Lista de nombres de inicio de sesión para este usuario

Type:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-State

Especifica el estado del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StreetAddress

Especifica la dirección postal del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Surname

Especifica el apellido del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TelephoneNumber

Especifica el número de teléfono del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UsageLocation

Código de país de dos letras (norma ISO 3166). Obligatorio para usuarios que tendrán licencias asignadas debido al requisito legal de comprobar la disponibilidad de servicios en países. Algunos ejemplos son: "US", "JP" y "GB". No acepta valores NULL.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

Especifica el nombre principal de usuario del usuario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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. Para los usuarios invitados, el estado puede ser PendingAcceptance o Accepted, o null para todos los demás usuarios.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserStateChangedOn

Muestra la marca de tiempo del cambio más reciente en la propiedad externalUserState.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserType

Un valor de cadena que se puede usar para clasificar tipos de usuario en el directorio, como "Member" y "Guest".

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False