你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzADUser

参考

模块:: Az.Resources

更新用户中的实体

语法

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

说明

更新用户中的实体

示例

示例 1：按用户主体名称更新用户

Update-AzADUser -UPNOrObjectId $upn -City $city

按用户主体名称更新用户

参数

-AccountEnabled

如果启用帐户，则为 true;否则为 false。与 -Password结合使用时始终为 true。更改帐户的密码时，将忽略 -AccountEnabled $false。

类型:	Boolean
别名:	EnableAccount
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AgeGroup

设置用户的年龄组。允许的值：null、minor、notAdult 和成人。有关详细信息，请参阅法定年龄组属性定义。支持$filter（eq、ne、NOT 和 in）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-City

用户所在的城市。最大长度为 128 个字符。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CompanyName

用户关联的公司名称。此属性可用于描述外部用户来自的公司。公司名称的最大长度为 64 个字符。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConsentProvidedForMinor

设置是否已为未成年人获取同意。允许的值：null、granted、denied 和 notRequired。有关详细信息，请参阅法定年龄组属性定义。支持$filter（eq、ne、NOT 和 in）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Country

用户所在的国家/地区;例如，美国或英国。最大长度为 128 个字符。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	PSObject
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeletedDateTime

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Department

用户在其中工作的部门的名称。最大长度为 64 个字符。支持$filter（eq、ne、NOT、ge、le 和运算符）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

用户通讯簿中显示的名称。此值通常是用户的名字、中间首字母和姓氏的组合。创建用户且在更新期间无法清除此属性时，此属性是必需的。最大长度为 256 个字符。支持$filter（eq、ne、NOT、ge、le、in、startsWith）、$orderBy和$search。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EmployeeHireDate

雇用用户的日期和时间，或者将来的雇用时将开始工作。支持$filter（eq、ne、NOT、ge、le、in）。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EmployeeId

组织分配给用户的员工标识符。支持$filter（eq、ne、NOT、ge、le、in、startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EmployeeType

捕获企业辅助角色类型。例如，员工、承包商、顾问或供应商。支持$filter（eq、ne、NOT、ge、le、in、startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ExternalUserState

对于使用邀请 API 邀请到租户的外部用户，此属性表示受邀用户的邀请状态。对于受邀用户，状态可以是 PendingAcceptance 或 Accepted，也可以是所有其他用户的 null。支持$filter（eq、ne、NOT、in）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ExternalUserStateChangeDateTime

显示 externalUserState 属性的最新更改的时间戳。支持$filter（eq、ne、NOT、in）。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FaxNumber

用户的传真号。支持$filter（eq、ne、NOT、ge、le、in、startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceChangePasswordNextLogin

如果用户必须在下一次成功登录时更改密码（true），则必须指定该密码。默认行为为 false，用于不更改下一次成功登录的密码。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-GivenName

用户的给定名称（名字）。最大长度为 64 个字符。支持$filter（eq、ne、NOT、ge、le、in、startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Id

只读。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Identity

表示可用于登录到此用户帐户的标识。标识可以由Microsoft（也称为本地帐户）、组织或社交标识提供者（如 Facebook、Google 和 Microsoft）提供，并绑定到用户帐户。可能包含具有相同 signInType 值的多个项。仅当 signInType 不是 userPrincipalName 时，才支持$filter （eq）。若要构造，请参阅 IDENTITY 属性的 NOTES 部分并创建哈希表。

类型:	IMicrosoftGraphObjectIdentity[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

用户输入对象

类型:	IMicrosoftGraphUser
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-IsResourceAccount

请勿使用 - 保留供将来使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-JobTitle

用户的职务。最大长度为 128 个字符。支持$filter（eq、ne、NOT、ge、le、in、startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Mail

用户的 SMTP 地址，例如，admin@contoso.com。对此属性的更改还将更新用户的 proxyAddresses 集合，以将值作为 SMTP 地址包含。虽然此属性可以包含重音字符，但使用这些字符可能会导致用户的其他Microsoft应用程序出现访问问题。支持 $filter （eq， ne， NOT， ge， le， in， startsWith， endsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MailNickname

用户的邮件别名。创建用户时必须指定此属性。最大长度为 64 个字符。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ObjectId

要更新的用户的用户主体名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OfficeLocation

用户业务地点中的办公室位置。最大长度为 128 个字符。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OnPremisesImmutableId

此属性用于将本地 Active Directory 用户帐户与其 Azure AD 用户对象相关联。如果在对用户的 userPrincipalName （UPN）属性使用联合域，则必须在 Graph 中创建新用户帐户时指定此属性。注意：指定此属性时不能使用 $ 和 _ 字符。仅在$select返回。支持$filter（eq、ne、NOT、ge、le、in）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OtherMail

用户的其他电子邮件地址列表;例如：['bob@contoso.com'， 'Robert@fabrikam.com']。注意：虽然此属性可以包含重音字符，但它们可能会导致对用户的第一方应用程序的访问问题。支持$filter（eq、NOT、ge、le、in、startsWith）。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PassThru

当命令成功时返回 true

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Password

用户的密码。创建用户时，此属性是必需的。

它可以更新，但需要用户才能在下次登录时更改密码。

密码必须满足用户 passwordPolicies 属性的 speci./fied 的最低要求。默认情况下，需要强密码。使用此方法更改密码时，AccountEnabled 设置为 true。

类型:	SecureString
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PasswordPolicy

指定用户的密码策略。此值是一个枚举，其中一个可能的值为 DisableStrongPassword，它允许指定的密码比默认策略弱。还可以指定 DisablePasswordExpiration。两者可以一起指定;例如：DisablePasswordExpiration、DisableStrongPassword.Supports $filter（ne、NOT）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PasswordProfile

passwordProfile 若要构造，请参阅 PASSWORDPROFILE 属性的 NOTES 部分并创建哈希表。

类型:	IMicrosoftGraphPasswordProfile
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PostalCode

用户的邮政编码。邮政编码特定于用户的国家/地区。在美国，此属性包含邮政编码。最大长度为 40 个字符。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PreferredLanguage

用户的首选语言。应遵循 ISO 639-1 代码;例如 en-US。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ShowInAddressList

如果 Outlook 全局地址列表应包含此用户，则为 true，否则为 false。如果未设置，则会将其视为 true。对于通过邀请管理器邀请的用户，此属性将设置为 false。支持$filter（eq、ne、NOT、in）。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-State

用户地址中的州或省。最大长度为 128 个字符。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StreetAddress

用户的营业地点的街道地址。最大长度为 1024 个字符。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Surname

用户的姓氏（姓氏或姓氏）。最大长度为 64 个字符。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UPNOrObjectId

要更新的用户的用户主体名称或对象 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-UsageLocation

两个字母国家/地区代码（ISO 标准 3166）。由于法律要求检查国家/地区服务的可用性，需要分配许可证的用户。示例包括：US、JP 和 GB。不可为 null。支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UserPrincipalName

用户的用户主体名称（UPN）。 UPN 是基于 Internet 标准 RFC 822 的用户的 Internet 样式登录名。按照约定，这应映射到用户的电子邮件名称。常规格式为alias@domain，其中域必须存在于租户的已验证域集合中。创建用户时，此属性是必需的。可以从组织的 verifiedDomains 属性访问租户的已验证域。注意：虽然此属性可以包含重音字符，但它们可能会导致对用户的第一方应用程序的访问问题。支持$filter（eq、ne、NOT、ge、le、in、startsWith、endsWith）和$orderBy。

类型:	String
别名:	UPN
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-UserType

可用于对目录中的用户类型进行分类的字符串值，例如成员和来宾。支持$filter（eq、ne、NOT、in、in）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

IMicrosoftGraphUser

输出

Boolean

备注

别名

Set-AzADUser

通过