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

Set-MsolUser

参考

模块:: MSOnline

修改 Azure Active Directory 中的用户。

语法

Set-MsolUser
   [-ImmutableId <String>]
   [-ObjectId <Guid>]
   [-UserPrincipalName <String>]
   [-BlockCredential <Boolean>]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DisplayName <String>]
   [-Fax <String>]
   [-FirstName <String>]
   [-LastName <String>]
   [-LastPasswordChangeTimestamp <DateTime>]
   [-MobilePhone <String>]
   [-Office <String>]
   [-PasswordNeverExpires <Boolean>]
   [-PhoneNumber <String>]
   [-PostalCode <String>]
   [-PreferredDataLocation <String>]
   [-PreferredLanguage <String>]
   [-SoftDeletionTimestamp <DateTime>]
   [-State <String>]
   [-StreetAddress <String>]
   [-StrongPasswordRequired <Boolean>]
   [-Title <String>]
   [-UsageLocation <String>]
   [-AlternateEmailAddresses <String[]>]
   [-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
   [-AlternateMobilePhones <String[]>]
   [-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
   [-StsRefreshTokensValidFrom <DateTime>]
   [-UserType <UserType>]
   [-TenantId <Guid>]
   [<CommonParameters>]

说明

Set-MsolUser cmdlet 修改用户对象。

此 cmdlet 仅用于更新基本属性。使用 Set-MsolUserLicense、Set-MsolUserPassword 和 Set-MsolUserPrincipalName cmdlet 更新用户的许可证、密码和用户主体名称。

示例

示例 1：阻止用户的凭据

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -BlockCredential $True

此命令将阻止凭据设置为用户$True，从而阻止他们登录。无法对已同步的用户执行此操作。

示例 2：更新显示名称

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -Title "Manager" -Department "Finance"

此命令更新指定用户的显示名称。

示例 3：设置用户的位置

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -UsageLocation "CA"

此命令设置用户的位置国家或地区。国家或地区必须是两个字母的 ISO 代码。可以设置已同步用户以及托管用户的位置。

示例 4：设置首选数据位置

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -PreferredDataLocation "EUR"

此命令将用户主体名称设置为 davidchew@contoso.com EUR 的用户的首选数据位置属性。

参数

-AlternateEmailAddresses

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

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

-AlternateMobilePhones

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

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

-BlockCredential

指定用户是否无法使用其用户 ID 登录。

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

-City

指定用户的城市。

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

-Country

指定用户的国家或地区。

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

-Department

指定用户的部门。

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

-DisplayName

指定用户的显示名称。

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

-Fax

指定用户的传真号。

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

-FirstName

指定用户的名字。

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

-ImmutableId

指定用户的联合标识的不可变 ID。对于具有标准标识的用户，应省略此项。

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

-LastName

指定用户的姓氏。

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

-LastPasswordChangeTimestamp

指定上次更改密码的时间。

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

-MobilePhone

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

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

-ObjectId

指定用户的唯一对象 ID。

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

-Office

指定用户办公室的位置。

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

-PasswordNeverExpires

指定用户密码是否定期过期。

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

-PhoneNumber

指定用户的电话号码。

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

-PostalCode

指定用户的邮政编码。

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

-PreferredDataLocation

指定用户的首选数据位置。

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

-PreferredLanguage

指定用户的首选语言。

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

-SoftDeletionTimestamp

指定软删除的时间。

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

-State

指定用户所在的省/市/自治区。

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

-StreetAddress

指定用户的街道地址。

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

-StrongAuthenticationMethods

指定强身份验证方法的数组。

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

-StrongAuthenticationRequirements

指定强身份验证要求的数组。

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

-StrongPasswordRequired

指定是否要求用户使用强密码。

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

-StsRefreshTokensValidFrom

指定 StsRefreshTokensValidFrom 值。

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

-TenantId

指定要对其执行操作的租户的唯一 ID。默认值为当前用户的租户。此参数仅适用于合作伙伴用户。

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

-Title

指定用户的标题。

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

-UsageLocation

指定使用服务的用户的位置。指定一个两个字母的国家或地区代码。

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

-UserPrincipalName

指定用户的用户 ID。

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

-UserType

指定用户类型。

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

通过