Set-SPUser
适用于： SharePoint Foundation 2010, SharePoint Server 2010
上一次修改主题： 2015-03-09
配置现有用户的属性。
Syntax
Set-SPUser [-Identity] <SPUserPipeBind> [-AddPermissionLevel <String[]>] [-AssignmentCollection <SPAssignmentCollection>] [-ClearPermissions <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-Email <String>] [-Group <SPGroupPipeBind>] [-IsSiteCollectionAdmin <SwitchParameter>] [-MobileNumber <String>] [-PassThru <SwitchParameter>] [-RemovePermissionLevel <String[]>] [-SyncFromAD <SwitchParameter>] [-Web <SPWebPipeBind>] [-WhatIf [<SwitchParameter>]]
详细说明
Set-SPUser cmdlet 配置现有用户的属性。
有关 Windows PowerShell for SharePoint 产品的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 参数 | 是否必需 | 类型 | 说明 |
|---|---|---|---|
Identity |
必需 |
Microsoft.SharePoint.PowerShell.SPUserPipeBind |
指定要返回的用户的 GUID、登录名或 SPUser 对象。 键入的值必须是 1234-5678-9876-0987 形式的有效用户 GUID。 |
AddPermissionLevel |
可选 |
System.String[] |
指定添加到此用户的权限级别。 键入的值必须为下列类型之一： -- 参与讨论 - 可以查看、添加、更新和删除列表项和文档。 -- 设计 - 可以查看、添加、更新、删除、审批和自定义文档。 -- 完全控制 - 具有对所有文档的完全控制权限。 -- 受限访问 - 如果授予了相应的权限，则可以查看特定列表、文档库、列表项、文件夹或文档。 -- 读取 - 可以查看页面和列表项，并下载文档。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 .gif "注意") Note
在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
|
ClearPermissions |
可选 |
System.Management.Automation.SwitchParameter |
清除用户的所有给定权限。如果给定了“清除和添加”值，则先清除这些权限，然后再给定新权限。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters |
DisplayName |
可选 |
System.String |
指定用户的新显示名称。 键入的值必须为有效名称。 |
可选 |
System.String |
指定用户的新电子邮件地址。 |
|
Group |
可选 |
Microsoft.SharePoint.PowerShell.SPGroupPipeBind |
将用户添加到给定网站的指定命名组。 |
IsSiteCollectionAdmin |
可选 |
无 |
指定是否将用户设置为网站集管理员。 |
MobileNumber |
可选 |
System.String |
设置用户的新手机号码。 |
PassThru |
可选 |
无 |
如果未提供此参数，则指明此 cmdlet 没有任何输出。如果提供了此参数，此参数则指明将返回此用户的 SPUser 对象。 |
RemovePermissionLevel |
可选 |
System.String[] |
删除用户的权限级别。 |
SyncFromAD |
可选 |
System.Management.Automation.SwitchParameter |
如果提供了此参数，则指定将根据用户目录存储同步用户信息。 |
Web |
可选 |
Microsoft.SharePoint.PowerShell.SPWebPipeBind |
指定要用作范围的 URL 或 GUID 的名称。如果 SPUser 对象作为标识提供，则不需要此参数。 键入的值必须 http://server_name 形式的有效 URL 或 1234-5678-9807 形式的 GUID。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters |
输入类型
返回类型
Example
------------------示例-----------------------
Set-SPUser -Identity 'Contoso\jdoe' -Web https://test -AddPermissionLevel "Contributor"
此示例在 https://test 上将用户 (Contoso\jdoe) 设置为参与者。