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

Set-AzureADUser

参考

模块:: AzureAD

更新用户。

语法

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

说明

Set-AzureADUser cmdlet 更新 Azure Active Directory (AD) 中的用户。

示例

示例 1：更新用户

PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com 
PS C:\> $user.DisplayName = 'YetAnotherTestUser' 
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.Displayname

示例 2：在家长同意的情况下，将所有其他指定用户设置为未成年人

Get-AzureADUser -All $true | 
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } | 
ForEach-Object  { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

此命令更新指定用户的属性。

参数

-AccountEnabled

指示帐户是否已启用。

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

-AgeGroup

由企业应用程序用于确定用户的法定年龄组。此属性是只读的，根据 ageGroup 和 consentProvidedForMinor 属性进行计算。允许的值：null、 minornotAdult 和 adult。请参阅 [法定年龄组属性定义][详细了解年龄组和未成年人同意定义]。

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

-City

指定用户的城市。

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

-CompanyName

与用户关联的公司名称。此属性可用于描述外部用户所在的公司。公司名称的最大长度为 64 个字符。

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

-ConsentProvidedForMinor

设置是否已获得未成年人的同意。允许的值：null、 granteddenied 和 notRequired。有关详细信息，请参阅[法定年龄组属性定义][详细了解年龄组和未成年人同意定义]。

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

-Country

指定用户的国家或地区。

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

-CreationType

指示用户帐户是否为 Azure Active Directory B2C 租户的本地帐户。可能的值为“LocalAccount”和 null。创建本地帐户时，该属性是必需的并且必须将其设置为“LocalAccount”。创建工作或学校帐户时，不指定该属性或者将其设置为 null。

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

-Department

指定用户的部门。

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

-DisplayName

指定用户的显示名称。

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

-ExtensionProperty

将数据作为基本 开放扩展 或通用性更高的 架构扩展添加到自定义用户属性。请参阅 [有关扩展的详细信息][了解有关扩展的详细信息]。

类型:	Dictionary<TKey,TValue>[System.String,System.String]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FacsimileTelephoneNumber

用户的传真号。

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

-GivenName

指定用户的给定名称。

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

-ImmutableId

此属性用于将本地 Active Directory 用户帐户关联到其 Azure AD 用户对象。如果将联合域用于用户的 userPrincipalName (UPN) 属性，则必须在 Graph 中创建新用户帐户时指定此属性。 重要： 指定 $ 此属性时，不能使用和 _ 字符。

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

-IsCompromised

如果此用户遭到入侵，则为 True

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

-JobTitle

指定用户的职务。

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

-MailNickName

指定用户邮件地址的昵称。

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

-Mobile

指定用户的移动电话号码。

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

-ObjectId

在 Azure AD 中将用户 id (指定为 UPN 或 ObjectId) 。

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

-OtherMails

指定用户的其他电子邮件地址。

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

-PasswordPolicies

为用户指定密码策略。

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

-PasswordProfile

指定用户的密码配置文件。

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

-PhysicalDeliveryOfficeName

用户营业地点的办公室位置。最大长度为 128 个字符。

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

-PostalCode

指定用户的邮政编码。

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

-PreferredLanguage

指定用户的首选语言。

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

-ShowInAddressList

设置为 True 以在地址列表中显示此用户。

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

-SignInNames

此用户的登录名列表

类型:	List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-State

指定用户的状态。

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

-StreetAddress

指定用户的街道地址。

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

-Surname

指定用户的姓氏。

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

-TelephoneNumber

指定用户的电话号码。

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

-UsageLocation

双字母国家或地区代码 (ISO 标准 3166) 。对于将分配许可证的用户是必需的，因为法律要求检查服务在国家和地区的可用性。示例包括：“US”、“JP”和“GB”。不可为 Null。

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

-UserPrincipalName

指定用户的用户主体名称。

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

-UserState

对于使用邀请 API 邀请到租户的外部用户，此属性表示受邀用户的邀请状态。对于受邀用户，状态可以是 PendingAcceptance 、 Accepted或 null ，对于所有其他用户。

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

-UserStateChangedOn

显示 externalUserState 属性的最新更改的时间戳。

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

-UserType

可用于对目录中用户类型进行分类的字符串值，如“Member”和“Guest”。

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

备注

请参阅 Set-AzureADUser 到 Microsoft Graph PowerShell 的迁移指南。

通过