Update-AzADUser

Sintaxis

UPNOrObjectIdParameterSet (valor predeterminado)

Update-AzADUser
    -UPNOrObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectIdParameterSet

Update-AzADUser
    -ObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Update-AzADUser
    -InputObject <IMicrosoftGraphUser>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UPNParameterSet

Update-AzADUser
    -UserPrincipalName <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Actualización del usuario por nombre principal de usuario

Update-AzADUser -UPNOrObjectId $upn -City $city

Parámetros

-AccountEnabled

true para habilitar la cuenta; de lo contrario, false. Siempre true cuando se combina con -Password. -AccountEnabled $false se omite al cambiar la contraseña de la cuenta.

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-ConsentProvidedForMinor

Determina si se ha obtenido el consentimiento 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).

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Conjuntos de parámetros

-DeletedDateTime

.

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-DisplayName

Nombre del usuario que aparece en la libreta de direcciones. El valor suele ser la combinación del nombre del usuario, la inicial del segundo nombre 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.

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-EmployeeId

El identificador de empleado asignado al usuario en la organización. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

-EmployeeType

Es para capturar el tipo de trabajador de la empresa. Por ejemplo, Empleado, Contratista, Consultor o Proveedor. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-ExternalUserStateChangeDateTime

Muestra la marca de tiempo del último cambio a la propiedad externalUserState. Admite $filter (eq, ne, NOT , in).

Propiedades de parámetro

Conjuntos de parámetros

-FaxNumber

El número de fax del usuario. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-GivenName

El nombre (nombre de pila) del usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

-Id

Solo lectura.

Propiedades de parámetro

Conjuntos de parámetros

-Identity

Representa las identidades que se pueden usar para iniciar sesión en esta cuenta de usuario. Microsoft puede proporcionar una identidad (también conocida como cuenta local), por organizaciones o por proveedores de identidades sociales, como Facebook, Google y Microsoft, y vinculadas a una cuenta de usuario. Puede contener varios elementos con el mismo valor signInType. Admite $filter (eq) solo donde signInType no es userPrincipalName. Para construir, consulte la sección NOTES de las propiedades IDENTITY y cree una tabla hash.

Propiedades de parámetro

Conjuntos de parámetros

-InputObject

objeto de entrada de usuario

Propiedades de parámetro

Conjuntos de parámetros

-IsResourceAccount

No usar: reservado para uso futuro.

Propiedades de parámetro

Conjuntos de parámetros

-JobTitle

Puesto del usuario. La longitud máxima es de 128 caracteres. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

-Mail

La dirección SMTP del usuario (por ejemplo, la dirección 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).

Propiedades de parámetro

Conjuntos de parámetros

-MailNickname

El alias de correo del usuario. Esta propiedad debe especificarse al crear un usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

-ObjectId

Nombre principal de usuario del usuario que se va a actualizar.

Propiedades de parámetro

Conjuntos de parámetros

-OfficeLocation

La ubicación de la oficina del lugar de trabajo del usuario. La longitud máxima es de 128 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

-OnPremisesImmutableId

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

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-PassThru

Devuelve true cuando el comando se ejecuta correctamente.

Propiedades de parámetro

Conjuntos de parámetros

-Password

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 manera predeterminada, se requiere una contraseña segura. Al cambiar la contraseña mediante este método, AccountEnabled se establece en true.

Propiedades de parámetro

Conjuntos de parámetros

-PasswordPolicy

Especifica las directivas de contraseña del 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).

Propiedades de parámetro

Conjuntos de parámetros

-PasswordProfile

passwordProfile Para construir, consulte la sección NOTES para las propiedades PASSWORDPROFILE y crear una tabla hash.

Propiedades de parámetro

Conjuntos de parámetros

-PostalCode

El código postal de la dirección del usuario. El código postal es específico del país o de la región del usuario. En Estados Unidos, este atributo contiene el código postal. La longitud máxima es de 40 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

-PreferredLanguage

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

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-State

El estado o la provincia de la dirección del usuario. La longitud máxima es de 128 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-Surname

El apellido (o apellidos) del usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

-UPNOrObjectId

Nombre principal de usuario o identificador de objeto del usuario que se va a actualizar.

Propiedades de parámetro

Conjuntos de parámetros

-UsageLocation

Un 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: EE. UU., JP y GB. No es anulable. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Propiedades de parámetro

Conjuntos de parámetros

-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, se debe asignar al nombre de correo electrónico del usuario. El formato general es alias@dominio, en donde el dominio debe estar presente en la colección de dominios verificados del espacio empresarial. 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.

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

IMicrosoftGraphUser

Salidas

Boolean

Notas