Partager via


Update-AzADUser

Mettre à jour l’entité dans les utilisateurs

Syntaxe

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

Mettre à jour l’entité dans les utilisateurs

Exemples

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

Update-AzADUser -UPNOrObjectId $upn -City $city

Mettre à jour l’utilisateur par nom d’utilisateur principal

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.

Type:Boolean
Alias:EnableAccount
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-City

Localité où se trouve l’utilisateur. La longueur maximale est de 128 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CompanyName

nom de l’entreprise à laquelle l’utilisateur est associé. Cette propriété peut être utile pour décrire l’entreprise à partir de laquelle 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).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConsentProvidedForMinor

Définit si le 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).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Country

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

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

Type:PSObject
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeletedDateTime

.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Nom affiché dans le carnet d’adresses de l’utilisateur. Cette valeur est généralement la combinaison du prénom de l’utilisateur, de son prénom, de son 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.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EmployeeId

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EmployeeType

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExternalUserStateChangeDateTime

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

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FaxNumber

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-GivenName

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Lecture seule.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:IMicrosoftGraphObjectIdentity[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

objet d’entrée utilisateur

Type:IMicrosoftGraphUser
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IsResourceAccount

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobTitle

Intitulé du poste de l’utilisateur. La longueur maximale est de 128 caractères. Prend en charge $filter (eq, ne, NOT , ge, le, in, startsWith).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Mail

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MailNickname

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ObjectId

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OfficeLocation

Emplacement du bureau de l’utilisateur. La longueur maximale est de 128 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Retourne true lorsque la commande réussit

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Password

Mot de passe de l’utilisateur. Cette propriété est requise lors de la création d’un utilisateur.

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 telles que speci./fied 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.

Type:SecureString
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PasswordPolicy

Spécifie les stratégies de mot de passe pour 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).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PasswordProfile

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

Type:IMicrosoftGraphPasswordProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PostalCode

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PreferredLanguage

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-State

État ou province dans l’adresse de l’utilisateur. La longueur maximale est de 128 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-StreetAddress

Adresse postale du lieu de travail de l’utilisateur. La longueur maximale est de 1 024 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Surname

Patronyme de l’utilisateur (nom). La longueur maximale est de 64 caractères. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UPNOrObjectId

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UsageLocation

Code de pays à deux lettres (norme ISO 3166). Requis pour les utilisateurs auxquels des licences seront attribuées en raison des exigences légales sur la vérification de la disponibilité des services dans les pays. Voici quelques exemples : US, JP et GB. N'accepte pas la valeur NULL. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserPrincipalName

Nom d’utilisateur principal (UPN) de l’utilisateur. L’UPN est un nom de connexion au format Internet d’un utilisateur selon la norme Internet RFC 822. Par convention, cela doit être mappé au nom de l’e-mail de l’utilisateur. Le format général est alias@domain, où le domaine doit être présent dans la collection de domaines vérifiés du locataire. Cette propriété est requise lors de la création d’un utilisateur. 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.

Type:String
Alias:UPN
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

IMicrosoftGraphUser

Sorties

Boolean

Notes

ALIAS

Set-AzADUser