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

New-MsolUser

模块:

MSOnline

创建 Azure Active Directory 的用户。

语法

New-MsolUser
   [-ImmutableId <String>]
   [-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>]
   [-Password <String>]
   [-LicenseOptions <LicenseOption[]>]
   [-ForceChangePassword <Boolean>]
   [-LicenseAssignment <String[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

说明

New-MsolUser cmdlet 在 Azure Active Directory 中创建用户。 若要授予用户对服务的访问权限，请使用 LicenseAssignment 参数分配许可证。

示例

示例 1：创建用户

PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"

此命令创建用户。 用户未分配任何许可证。 为用户生成随机密码。

示例 2：创建用户并分配许可证

注意

-LicenseAssignment 参数已弃用。 了解如何使用 Microsoft Graph PowerShell 分配许可证。 有关详细信息，请参阅 分配许可证 Microsoft Graph API。

PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"

此命令将创建新用户并分配许可证。

示例 3：创建用户和首选数据位置

PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"

此命令创建一个用户，其用户主体名称为 jdavidchew@contoso.onmicrosoft.com，显示名称为 David，首选数据位置为 EUR。

参数

-AlternateEmailAddresses

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

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

-AlternateMobilePhones

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

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

-BlockCredential

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

类型:	Boolean
Position:	Named
默认值:	$false
必需:	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

-ForceChangePassword

指示用户在下次登录时需要更改其密码。

类型:	Boolean
Position:	Named
默认值:	$true
必需:	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

-LicenseAssignment

指定要分配用户的许可证数组。

注意

-LicenseAssignment 参数已弃用。 了解如何使用 Microsoft Graph PowerShell 分配许可证。 有关详细信息，请参阅 分配许可证 Microsoft Graph API。

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

-LicenseOptions

指定许可证分配的选项。 用于选择性地禁用 SKU 中的单个服务计划。

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

-MobilePhone

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

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

-Office

指定用户的办公室。

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

-Password

指定用户的新密码。 如果将用户设置为要求提供强密码，则必须符合下列所有规则：

• 密码必须至少包含一个小写字母
• 密码必须至少包含一个大写字母
• 密码必须至少包含一个非字母数字字符
• 密码不能包含任何空格、制表符或换行符
• 密码长度必须为 8-16 个字符
• 用户名不能包含在密码中

如果省略此值，则会向用户分配随机密码。

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

-PasswordNeverExpires

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

类型:	Boolean
Position:	Named
默认值:	$false
必需:	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
默认值:	$true
必需:	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

输出

Microsoft.Online.Administration.User

此 cmdlet 返回有关已创建的新用户的详细信息，包括其临时密码。

相关链接

• Get-MsolUser
• Remove-MsolUser
• Restore-MsolUser
• Set-MsolUser