Update-AzADUser

Referencia

Módulo:: Az.Resources

Actualiza la entidad en los usuarios

Sintaxis

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

Update-AzADUser
      [-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>]
      -ObjectId <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADUser
      [-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>]
      -InputObject <IMicrosoftGraphUser>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADUser
      [-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>]
      -UserPrincipalName <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Actualiza la entidad en los usuarios

Ejemplos

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

Update-AzADUser -UPNOrObjectId $upn -City $city

Actualización del usuario por nombre principal de usuario

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.

Tipo:	Boolean
Alias:	EnableAccount
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-City

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

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	PSObject
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DeletedDateTime

Tipo:	DateTime
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Department

Nombre del departamento en el que funciona el usuario. La longitud máxima es de 64 caracteres. Admite $filter (eq, ne, NOT , ge, le y en operadores).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	DateTime
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EmployeeId

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EmployeeType

Captura el tipo de trabajo empresarial. Por ejemplo, Empleado, Contratista, Consultor o Proveedor. Admite $filter (eq, ne, NOT , ge, le, in, startsWith).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ExternalUserStateChangeDateTime

Muestra la marca de tiempo para el cambio más reciente a la propiedad externalUserState. Admite $filter (eq, ne, NOT , in).

Tipo:	DateTime
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FaxNumber

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-GivenName

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Id

Solo lectura.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

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

Tipo:	IMicrosoftGraphObjectIdentity[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

objeto de entrada de usuario

Tipo:	IMicrosoftGraphUser
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-IsResourceAccount

No usar: reservado para uso futuro.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-JobTitle

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Mail

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MailNickname

Alias de correo para el 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).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ObjectId

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-OfficeLocation

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PassThru

Devuelve true cuando el comando se ejecuta correctamente.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-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 como speci./fied por la propiedad passwordPolicies del usuario. De forma predeterminada, se requiere una contraseña segura. Al cambiar la contraseña mediante este método, AccountEnabled se establece en true.

Tipo:	SecureString
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PasswordProfile

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

Tipo:	IMicrosoftGraphPasswordProfile
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PostalCode

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PreferredLanguage

Idioma preferido para el usuario. Debe seguir el código ISO 639-1; por ejemplo, en-US. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-State

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StreetAddress

Dirección postal del lugar de negocio del usuario. La longitud máxima es de 1024 caracteres. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Surname

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UPNOrObjectId

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UsageLocation

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: US, JP y GB. No acepta valores NULL. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

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

Tipo:	String
Alias:	UPN
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

IMicrosoftGraphUser

Salidas

Boolean

Notas

ALIAS

Set-AzADUser

Compartir a través de