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[] |
指定要新增至使用者的權限層級。 此類型必須是任何下列類型其中一項： -- Contribute - 可檢視、新增、更新及刪除清單項目與文件。 -- Design - 可檢視、新增、更新、刪除、核准及自訂文件。 -- Full Control – 可完全控制所有文件。 Limited Access 授與權限後可檢視特定清單、文件庫、清單項目、資料夾或文件。 Read - 可檢視頁面、清單項目與下載文件。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 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"
此範例會將使用者 (Contoso\jdoe) 設定為 https://test 上的參與者。