New-SPUser
适用于： SharePoint Foundation 2010, SharePoint Server 2010
上一次修改主题： 2015-03-09
将现有用户添加到具有指定权限的 SharePoint 网站。
Syntax
New-SPUser [-UserAlias] <String> -Web <SPWebPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-Email <String>] [-Group <SPGroupPipeBind>] [-MobileNumber <String>] [-PermissionLevel <String[]>] [-SiteCollectionAdmin <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
New-SPUser cmdlet 将现有用户添加到具有指定权限的 SharePoint 网站。在继承这些权限的所有子网站中，该用户具有给定的权限。该用户帐户必须已存在于用户目录中。
如果您的环境处于 Active Directory 模式下，则该用户必须已存在于 Active Directory 域服务 (AD DS) 中，并且只需要 UserAlias 参数；所有其他字段将从 AD DS 中提取。如果仅给定别名，并且服务器场处于 Active Directory 帐户创建模式下，则还需要 Email 参数。
有关 Windows PowerShell for SharePoint 产品的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
UserAlias |
必需 |
System.String |
|
Web |
必需 |
Microsoft.SharePoint.PowerShell.SPWebPipeBind |
指定要在其上创建此用户的 Web 的 URL 或 GUID。 该类型必须是格式为 http://server_name 的有效 URL 或者格式为 1234-5678-9876-0987 的 GUID。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 .gif "注意") Note
在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
|
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters |
DisplayName |
可选 |
System.String |
指定包含用户的显示名称的字符串。 该类型必须是有效的用户名；例如，Joe。 |
可选 |
System.String |
指定新用户的电子邮件地址。 该类型必须是格式为 someone@example.com 的有效电子邮件地址。 |
|
Group |
可选 |
Microsoft.SharePoint.PowerShell.SPGroupPipeBind |
指定新用户所属的用户组。 |
MobileNumber |
可选 |
System.String |
指定新用户的用户电子邮件地址。 该类型必须是格式为 someone@example.com 的有效电子邮件地址。 |
PermissionLevel |
可选 |
System.String[] |
将用户添加到某个权限策略级别。 该类型必须是有效的用户权限策略级别；例如，Full、Read、Contribute 或 All。 |
SiteCollectionAdmin |
可选 |
System.Management.Automation.SwitchParameter |
指定是否将用户添加为网站集管理员。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters |
输入类型
返回类型
Example
------------------示例 1----------------------
PS> New-SPUser - UserAlias 'Contoso\Jdoe'-displayname 'John Doe' -web https://contoso.com
此示例将名为 John Doe 的新用户添加到 Contoso 域中。
------------------示例 2----------------------
Get-SPWeb http://sitename | New-SPUser -UserAlias Contoso\Jdoe
此示例将 Contoso\Jdoe 添加到 http://sitename 网站集中的所有 Web。由于该网站集使用继承的权限，因此仅需涉及顶级网站。