Set-EntraBetaUser

Set-EntraBetaUser

    -UserId <String>
    [-PostalCode <String>]
    [-CompanyName <String>]
    [-GivenName <String>]
    [-Mobile <String>]
    [-PreferredLanguage <String>]
    [-CreationType <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-AgeGroup <String>]
    [-MailNickName <String>]
    [-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
    [-ConsentProvidedForMinor <String>]
    [-ImmutableId <String>]
    [-Country <String>]
    [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
    [-Department <String>]
    [-StreetAddress <String>]
    [-PasswordPolicies <String>]
    [-JobTitle <String>]
    [-City <String>]
    [-OtherMails <System.Collections.Generic.List`1[System.String]>]
    [-UserPrincipalName <String>]
    [-DisplayName <String>]
    [-AccountEnabled <Boolean>]
    [-PasswordProfile <PasswordProfile>]
    [-State <String>]
    [-TelephoneNumber <String>]
    [-Surname <String>]
    [-ShowInAddressList <Boolean>]
    [<CommonParameters>]

L’applet Set-EntraBetaUser de commande met à jour un utilisateur dans Microsoft Entra ID. Spécifiez le UserId paramètre pour mettre à jour un utilisateur dans Microsoft Entra ID.

Update-EntraBetaUser est un alias pour Set-EntraBetaUser.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -DisplayName 'Updated user Name'

Cet exemple met à jour le paramètre Nom d’affichage de l’utilisateur spécifié.

• -UserId Spécifie l’ID en tant que nom d’utilisateur principal (UPN) ou UserId.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -AccountEnabled $true

Cet exemple met à jour le paramètre AccountEnabled de l’utilisateur spécifié.

• -UserId Spécifie l’ID en tant que nom d’utilisateur principal (UPN) ou UserId.
• -AccountEnabled Spécifie si le compte est activé.

Connect-Entra -Scopes 'User.ReadWrite.All'
Get-EntraBetaUser -All | Where-Object -Property DisplayName -Match '(George|James|Education)' |
ForEach-Object { Set-EntraBetaUser -UserId $($_.Id) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

Cet exemple met à jour les utilisateurs spécifiés en tant que mineurs avec le consentement parental.

• -UserId Spécifie l’ID en tant que nom d’utilisateur principal (UPN) ou UserId.
• -ConsentProvidedForMinor Définit si le consentement doit être obtenu pour les mineurs. Valeurs autorisées : null, accordée, refusée et notRequired.

Connect-Entra -Scopes 'User.ReadWrite.All'
$params = @{
    UserId           = 'SawyerM@contoso.com'
    City             = 'Add city name'
    CompanyName      = 'Microsoft'
    Country          = 'Add country name'
    Department       = 'Add department name'
    GivenName        = 'Sawyer Miller G'
    JobTitle         = 'Manager'
    MailNickName     = 'Add mailnickname'
    Mobile           = '9984534564'
    OtherMails       = 'johndoe@contosodev.com'
    PasswordPolicies = 'DisableStrongPassword'
    State            = 'UP'
    StreetAddress    = 'Add address'
    UserType         = 'Member'
}
Set-EntraBetaUser @params

Cet exemple met à jour la propriété de l’utilisateur spécifié.

• -UserId Spécifie l’ID en tant que nom d’utilisateur principal (UPN) ou UserId.
• -UserType classifiez les types d’utilisateurs dans votre annuaire, tels que « Membre » et « Invité ».
• -PasswordPolicies Spécifie les stratégies de mot de passe pour l’utilisateur.
• -OtherMails Spécifie d’autres adresses e-mail pour l’utilisateur

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -PasswordProfile @{
    Password = '*****'
    ForceChangePasswordNextSignIn = $true
}

Cet exemple met à jour le paramètre PasswordProfile de l’utilisateur spécifié.

• -UserId Spécifie l’ID en tant que nom d’utilisateur principal (UPN) ou UserId.
• -PasswordProfile spécifie le profil de mot de passe de l’utilisateur.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -UsageLocation 'US'

Cet exemple met à jour l’emplacement d’utilisation de l’utilisateur spécifié pour la gestion des licences.

• -UserId Spécifie l’ID en tant que nom d’utilisateur principal (UPN) ou UserId.
• -UsageLocation spécifie l’emplacement d’utilisation de l’utilisateur. Code pays ISO 3166 à deux lettres. Obligatoire pour que les utilisateurs sous licence vérifient la disponibilité du service. Exemples : US, JP, GB. Ne peut pas accepter la valeur Null.

Connect-Entra -Scopes 'User.ReadWrite.All'
Get-EntraBetaUser -UserId 'SawyerM@contoso.com' | Set-EntraBetaUser -PasswordPolicies DisablePasswordExpiration

Cet exemple met à jour la stratégie de mot de passe de l’utilisateur spécifié.

Les valeurs possibles pour la stratégie de mot de passe sont les suivantes :

• DisableStrongPassword: autorise les mots de passe plus faibles que la stratégie par défaut.
• DisablePasswordExpiration: empêche l’expiration des mots de passe.

Vous pouvez spécifier les deux valeurs ensemble, par exemple : DisablePasswordExpiration et DisableStrongPassword. Par exemple : Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -PasswordPolicies "DisablePasswordExpiration,DisableStrongPassword".

Connect-Entra -Scopes 'User.ReadWrite.All'
$application = Get-EntraBetaApplication -Filter "DisplayName eq 'Helpdesk Application'"
$extensionName = (Get-EntraBetaApplicationExtensionProperty -ApplicationId $application.Id).Name | Select-Object -First 1
$additionalProperties = @{ $extensionName = "Survey.Report" }
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -AdditionalProperties $additionalProperties

Cet exemple met à jour les propriétés d’extension de l’utilisateur spécifié, par exemple un rôle d’application pour une application.

• -UserId Spécifie l’ID en tant que nom d’utilisateur principal (UPN) ou UserId.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -AdditionalProperties @{
    onPremisesExtensionAttributes = @{
        extensionAttribute1 = "Job Group D"
        extensionAttribute2 = "Audit Role"
    }
}

Cet exemple met à jour les propriétés onPremisesExtensionAttributes de l’utilisateur spécifié.

• -UserId Spécifie l’ID en tant que nom d’utilisateur principal (UPN) ou UserId.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -BusinessPhones '+1 425 555 0109' -OfficeLocation '18/2111'

Cet exemple met à jour les propriétés onPremisesExtensionAttributes de l’utilisateur spécifié.

• -UserId Spécifie l’ID en tant que nom d’utilisateur principal (UPN) ou UserId.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Update-EntraBetaUser est un alias pour Set-EntraBetaUser.