Update-AzADUser

Syntaxe

UPNOrObjectIdParameterSet (Par défaut)

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

Exemples

Exemple 1 : Mettre à jour l’utilisateur par nom d’utilisateur principal

Update-AzADUser -UPNOrObjectId $upn -City $city

Paramètres

-AccountEnabled

true pour l’activation du compte ; sinon, false. Toujours true lorsqu’elle est combinée à -Password. -AccountEnabled $false est ignoré lors de la modification du mot de passe du compte.

Propriétés du paramètre

Jeux de paramètres

-AgeGroup

Définit le groupe d’âge de l’utilisateur. Valeurs autorisées : null, mineure, notAdult et adulte. Pour plus d’informations, reportez-vous aux définitions de propriétés du groupe d’âge légal. Prend en charge $filter (eq, ne, NOT et in).

Propriétés du paramètre

Jeux de paramètres

-City

Ville dans laquelle se trouve l’utilisateur. Sa longueur maximale est limitée à 128 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-CompanyName

Nom de la société associé à l’utilisateur. Cette propriété peut être utile pour décrire la société dont provient un utilisateur externe. La longueur maximale du nom de la société est de 64 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-ConsentProvidedForMinor

Définit si un consentement a été obtenu pour les mineurs. Valeurs autorisées : null, accordée, refusée et notRequired. Pour plus d’informations, reportez-vous aux définitions de propriétés du groupe d’âge légal. Prend en charge $filter (eq, ne, NOT et in).

Propriétés du paramètre

Jeux de paramètres

-Country

Pays/région dans lequel se trouve l’utilisateur ; par exemple, états-Unis ou Royaume-Uni. Sa longueur maximale est limitée à 128 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Jeux de paramètres

-DeletedDateTime

.

Propriétés du paramètre

Jeux de paramètres

-Department

Nom du service où travaille l’utilisateur. La longueur maximale est de 64 caractères. Prend en charge $filter (eq, ne, NOT , ge, le et in opérateurs).

Propriétés du paramètre

Jeux de paramètres

-DisplayName

Nom affiché dans le carnet d’adresses de l’utilisateur. Il s’agit généralement de la combinaison du prénom de l’utilisateur, de l’initiale de son deuxième prénom et de son nom. Cette propriété est requise lorsqu’un utilisateur est créé et qu’il ne peut pas être effacé pendant les mises à jour. La longueur maximale est de 256 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy et $search.

Propriétés du paramètre

Jeux de paramètres

-EmployeeHireDate

Date et heure à laquelle l’utilisateur a été embauché ou démarrera son travail en cas d’embauche ultérieure. Prend en charge $filter (eq, ne, NOT , ge, le, in).

Propriétés du paramètre

Jeux de paramètres

-EmployeeId

Identificateur d’employé attribué à l’utilisateur par l’organisation. Prend en charge $filter (eq, ne, NOT , ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-EmployeeType

Capture le type de travailleur d’entreprise. Par exemple, employé, entrepreneur, consultant ou fournisseur. Prend en charge $filter (eq, ne, NOT , ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-ExternalUserState

Pour un utilisateur externe invité au locataire à l’aide de l’API d’invitation, cette propriété représente l’état d’invitation de l’utilisateur invité. Pour les utilisateurs invités, l’état peut être PendingAcceptance ou Accepté, ou Null pour tous les autres utilisateurs. Prend en charge $filter (eq, ne, NOT , in).

Propriétés du paramètre

Jeux de paramètres

-ExternalUserStateChangeDateTime

Affiche l’horodatage de la dernière modification apportée à la propriété externalUserState. Prend en charge $filter (eq, ne, NOT , in).

Propriétés du paramètre

Jeux de paramètres

-FaxNumber

Numéro du télécopieur de l’utilisateur. Prend en charge $filter (eq, ne, NOT , ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-ForceChangePasswordNextLogin

Elle doit être spécifiée si l’utilisateur doit modifier le mot de passe lors de la prochaine connexion réussie (true). Le comportement par défaut est (false) pour ne pas modifier le mot de passe lors de la prochaine connexion réussie.

Propriétés du paramètre

Jeux de paramètres

-GivenName

Prénom de l’utilisateur. Longueur maximale : 64 caractères. Prend en charge $filter (eq, ne, NOT , ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-Id

Lecture seule.

Propriétés du paramètre

Jeux de paramètres

-Identity

Représente les identités qui peuvent être utilisées pour se connecter à ce compte d’utilisateur. Une identité peut être fournie par Microsoft (également appelée compte local), par des organisations ou par des fournisseurs d’identité sociale tels que Facebook, Google et Microsoft, et liés à un compte d’utilisateur. Peut contenir plusieurs éléments avec la même valeur signInType. Prend en charge $filter (eq) uniquement où signInType n’est pas userPrincipalName. Pour construire, consultez la section NOTES pour les propriétés IDENTITY et créez une table de hachage.

Propriétés du paramètre

Jeux de paramètres

-InputObject

objet d’entrée utilisateur

Propriétés du paramètre

Jeux de paramètres

-IsResourceAccount

N’utilisez pas : réservé pour une utilisation ultérieure.

Propriétés du paramètre

Jeux de paramètres

-JobTitle

Fonction de l’utilisateur. Sa longueur maximale est limitée à 128 caractères. Prend en charge $filter (eq, ne, NOT , ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-Mail

L’adresse SMTP de l’utilisateur, par exemple, admin@contoso.com. Les modifications apportées à cette propriété mettent également à jour la collection proxyAddresses de l’utilisateur pour inclure la valeur en tant qu’adresse SMTP. Bien que cette propriété puisse contenir des caractères d’accentuation, l’utilisation peut entraîner des problèmes d’accès avec d’autres applications Microsoft pour l’utilisateur. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Propriétés du paramètre

Jeux de paramètres

-MailNickname

L’alias de messagerie pour l’utilisateur. Cette propriété doit être spécifiée lors de la création d’un utilisateur. Longueur maximale : 64 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-ObjectId

Nom d’utilisateur principal de l’utilisateur à mettre à jour.

Propriétés du paramètre

Jeux de paramètres

-OfficeLocation

Emplacement du bureau de l’utilisateur dans l’entreprise. Sa longueur maximale est limitée à 128 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-OnPremisesImmutableId

Cette propriété est utilisée pour associer un compte d’utilisateur Active Directory local à son objet utilisateur Azure AD. Cette propriété doit être spécifiée lors de la création d’un compte d’utilisateur dans Graph si vous utilisez un domaine fédéré pour la propriété userPrincipalName (UPN) de l’utilisateur. REMARQUE : Les caractères $ et _ ne peuvent pas être utilisés lors de la spécification de cette propriété. Retourné uniquement sur $select. Prend en charge $filter (eq, ne, NOT, ge, le, in)..

Propriétés du paramètre

Jeux de paramètres

-OtherMail

Liste d’adresses e-mail supplémentaires pour l’utilisateur ; par exemple : [''bob@contoso.com, 'Robert@fabrikam.com']. REMARQUE : Bien que cette propriété puisse contenir des caractères d’accentuation, elles peuvent provoquer des problèmes d’accès à des applications internes pour l’utilisateur. Prend en charge $filter (eq, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-PassThru

Retourne true lorsque la commande réussit

Propriétés du paramètre

Jeux de paramètres

-Password

Mot de passe de l’utilisateur. Cette propriété est requise lorsqu’un utilisateur est créé.

Il peut être mis à jour, mais l’utilisateur doit modifier le mot de passe lors de la prochaine connexion.

Le mot de passe doit satisfaire aux exigences minimales spécifiées par la propriété passwordPolicies de l’utilisateur. Par défaut, un mot de passe fort est requis. Lorsque vous modifiez le mot de passe à l’aide de cette méthode, AccountEnabled a la valeur true.

Propriétés du paramètre

Jeux de paramètres

-PasswordPolicy

Spécifie les stratégies de mot de passe de l’utilisateur. Cette valeur est une énumération avec une valeur possible de DisableStrongPassword, ce qui permet de spécifier des mots de passe plus faibles que la stratégie par défaut. DisablePasswordExpiration peut également être spécifié. Les deux peuvent être spécifiés ensemble ; par exemple : DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Propriétés du paramètre

Jeux de paramètres

-PasswordProfile

passwordProfile To construct, see NOTES section for PASSWORDPROFILE properties and create a hash table.

Propriétés du paramètre

Jeux de paramètres

-PostalCode

Code postal de l’adresse de l’utilisateur. Le code postal est spécifique au pays/à la région de l’utilisateur. Aux États-Unis d’Amérique, cet attribut contient le code ZIP. Sa longueur maximale est limitée à 40 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-PreferredLanguage

Langue par défaut de l’utilisateur. Doit suivre le code ISO 639-1 ; par exemple en-US. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-ShowInAddressList

true si la liste d’adresses globale Outlook doit contenir cet utilisateur, sinon false. S’il n’est pas défini, cette valeur est traitée comme true. Pour les utilisateurs invités par le biais du gestionnaire d’invitations, cette propriété est définie sur false. Prend en charge $filter (eq, ne, NOT, in).

Propriétés du paramètre

Jeux de paramètres

-State

Département ou province où habite l’utilisateur. Sa longueur maximale est limitée à 128 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-StreetAddress

Adresse postale de l’entreprise de l’utilisateur. Sa longueur maximale est limitée à 1024 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-Surname

Nom de l’utilisateur (nom de famille). Longueur maximale : 64 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-UPNOrObjectId

Nom d’utilisateur principal ou ID d’objet de l’utilisateur à mettre à jour.

Propriétés du paramètre

Jeux de paramètres

-UsageLocation

Code pays à deux lettres (norme ISO 3166). Requis pour les utilisateurs auxquels des licences seront attribuées en raison d’une exigence légale pour vérifier la disponibilité des services dans les pays. Voici quelques exemples : ÉTATS-UNIS, JP et GB. Ne pouvant accepter la valeur null. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Jeux de paramètres

-UserPrincipalName

Nom d’utilisateur principal (UPN) de l’utilisateur. L’UPN est un nom de connexion de style Internet pour l’utilisateur basé sur la norme Internet RFC 822. Par convention, il doit être mappé sur le nom de messagerie de l’utilisateur. Le format général est alias@domaine, où le domaine doit être présent dans la collection de domaines vérifiés du client. Cette propriété est requise lorsqu’un utilisateur est créé. Les domaines vérifiés pour le locataire sont accessibles à partir de la propriété verifiedDomains de l’organisation. REMARQUE : Bien que cette propriété puisse contenir des caractères d’accentuation, elles peuvent provoquer des problèmes d’accès à des applications internes pour l’utilisateur. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) et $orderBy.

Propriétés du paramètre

Jeux de paramètres

-UserType

Valeur de chaîne qui peut être utilisée pour classer les types d’utilisateurs dans votre annuaire, tels que Membre et Invité. Prend en charge $filter (eq, ne, NOT, in,).

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

IMicrosoftGraphUser

Sorties

Boolean

Notes