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

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 ユーザー プリンシパル名 (UPN) または UserId として ID を指定します。

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

次の使用例は、指定したユーザーの AccountEnabled パラメーターを更新します。

• -UserId ユーザー プリンシパル名 (UPN) または UserId として 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 ユーザー プリンシパル名 (UPN) または UserId として ID を指定します。
• -ConsentProvidedForMinor 未成年者に対して同意を得る必要があるかどうかを設定します。 許可される値: null、許可、拒否、および 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 ユーザー プリンシパル名 (UPN) または UserId として ID を指定します。
• -UserType "Member" や "Guest" など、ディレクトリ内のユーザーの種類を分類します。
• -PasswordPolicies ユーザーのパスワード ポリシーを指定します。
• -OtherMails ユーザーのその他の電子メール アドレスを指定します

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

次の使用例は、指定したユーザーの PasswordProfile パラメーターを更新します。

• -UserId ユーザー プリンシパル名 (UPN) または UserId として ID を指定します。
• -PasswordProfile は、ユーザーのパスワード プロファイルを指定します。

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

次の使用例は、指定したユーザーのライセンス管理の使用場所を更新します。

• -UserId ユーザー プリンシパル名 (UPN) または UserId として ID を指定します。
• -UsageLocation は、ユーザーの使用場所を指定します。 2 文字の ISO 3166 国コード。 ライセンスを持つユーザーがサービスの可用性を確認するために必要です。 例: US、JP、GB。 NULL 値は許可されません。

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 ユーザー プリンシパル名 (UPN) または UserId として ID を指定します。

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

次の使用例は、指定したユーザーの onPremisesExtensionAttributes プロパティを更新します。

• -UserId ユーザー プリンシパル名 (UPN) または UserId として ID を指定します。

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

次の使用例は、指定したユーザーの onPremisesExtensionAttributes プロパティを更新します。

• -UserId ユーザー プリンシパル名 (UPN) または UserId として ID を指定します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

Update-EntraUser は Set-EntraUser の別名です。