New-SPUser

模块:: SharePointServer module

将现有用户添加到具有指定权限的 SharePoint 网站。

语法

Default （默认值）

New-SPUser
    [-UserAlias] <String>
    -Web <SPWebPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-DisplayName <String>]
    [-Email <String>]
    [-Group <SPGroupPipeBind>]
    [-PermissionLevel <String[]>]
    [-SiteCollectionAdmin]
    [-WhatIf]
    [<CommonParameters>]

说明

该 New-SPUser cmdlet 将现有用户添加到具有指定权限的 SharePoint 网站。在继承权限的所有子网站中，该用户具有给定的权限。该用户帐户必须已存在于用户目录中。

如果您的环境处于 Active Directory 模式下，则该用户必须已存在于 Active Directory 域服务 (AD DS) 中，并且只需要 UserAlias 参数；所有其他字段将从 AD DS 中提取。如果仅给定别名，并且服务器场处于 Active Directory 帐户创建模式下，则还需要 Email 参数。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息，请参阅 SharePoint Server cmdlet。

示例

示例 1

New-SPUser -UserAlias 'Contoso\Jdow'-DisplayName 'Jane Dow' -Web https://contoso.com

此示例将名为 Jane Dow 的新用户添加到 Contoso 域中。

示例 2

Get-SPWeb https://sitename | New-SPUser -UserAlias Contoso\Jdow

本示例将 Contoso\Jdow 添加到网站集中的所有 Web https://sitename 。由于该网站集使用继承的权限，因此仅需涉及首要网站。

参数

-AssignmentCollection

管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。

使用全局参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

参数属性

类型:	SPAssignmentCollection
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

执行命令前，看到确认提示。有关详细信息，请键入以下命令：get-help about_commonparameters

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DisplayName

指定包含用户的显示名称的字符串。

键入的值必须是有效的用户名；例如，Joe。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Email

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

类型必须是有效的电子邮件地址，格式 someone@contoso.com为。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Group

指定新用户所属的用户组。

参数属性

类型:	SPGroupPipeBind
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PermissionLevel

将用户添加到某权限级别。

键入的值必须是 Web 应用程序的有效权限级别；例如， Full Control 、 Read 、 Contribute 或 All 。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SiteCollectionAdmin

指定是否将用户添加为网站集管理员。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UserAlias

从 Active Directory 域服务 (AD DS) 指定用户别名。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Web

指定要在其上创建此用户的 Web 的 URL 或 GUID。

键入的值必须是格式为 https://server_name 的有效 URL 或者格式为 1234-5678-9876-0987 的 GUID。

参数属性

类型:	SPWebPipeBind
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

反馈

此页面是否有帮助？