Set-EntraUser

Set-EntraUser

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

這個 cmdlet 會Set-EntraUser更新 Microsoft Entra ID 中的使用者。 在 Microsoft Entra ID 中指定UserId更新使用者的參數。

Update-EntraUser 是 Set-EntraUser 的別名。

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

此範例更新指定使用者的顯示名稱參數。

• -UserId 指定 ID 為使用者主體名稱（UPN）或使用者 ID。

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

此範例更新指定使用者的 AccountEnabled 參數。

• -UserId 指定 ID 為使用者主體名稱（UPN）或使用者 ID。
• -AccountEnabled 指定帳號是否啟用。

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

此範例是在父母同意下更新指定使用者為未成年人。

• -UserId 指定 ID 為使用者主體名稱（UPN）或使用者 ID。
• -ConsentProvidedForMinor 規定未成年人是否必須取得同意。 允許的值有：null、granted、denied 和 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-EntraUser @params

此範例更新了指定的使用者屬性。

• -UserId 指定 ID 為使用者主體名稱（UPN）或使用者 ID。
• -UserType 在目錄中分類使用者類型，例如「成員」和「訪客」。
• -PasswordPolicies 為使用者指定密碼政策。
• -OtherMails 指定使用者的其他電子郵件地址

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

此範例更新指定使用者的 PasswordProfile 參數。

• -UserId 指定 ID 為使用者主體名稱（UPN）或使用者 ID。
• -PasswordProfile 指定使用者的密碼設定檔。

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

此範例更新指定使用者的使用位置以管理授權。

• -UserId 指定 ID 為使用者主體名稱（UPN）或使用者 ID。
• -UsageLocation 指定使用者的使用地點。 ISO 3166 國家代碼為兩字母。 授權使用者必須檢查服務可用性。 例子：美國、日本、英國。 不可為空。

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

此範例更新指定使用者的密碼政策。

密碼政策可能的值包括：

• DisableStrongPassword：允許比預設政策更弱的密碼。
• DisablePasswordExpiration： 防止密碼過期。

你可以同時指定兩個值，例如： DisablePasswordExpiration 和 DisableStrongPassword。 例如： Set-EntraUser -UserId 'SawyerM@contoso.com' -PasswordPolicies "DisablePasswordExpiration,DisableStrongPassword" 。

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

此範例更新指定使用者的擴充功能屬性，例如應用程式角色。

• -UserId 指定 ID 為使用者主體名稱（UPN）或使用者 ID。

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

此範例更新指定使用者的 onPremisesExtensionAttributes 屬性。

• -UserId 指定 ID 為使用者主體名稱（UPN）或使用者 ID。

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

此範例更新指定使用者的 onPremisesExtensionAttributes 屬性。

• -UserId 指定 ID 為使用者主體名稱（UPN）或使用者 ID。

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

Update-EntraUser 是 Set-EntraUser 的別名。