Set-SPUser
設定現有使用者的屬性。
Syntax
Set-SPUser
[-Identity] <SPUserPipeBind>
[-AddPermissionLevel <String[]>]
[-AssignmentCollection <SPAssignmentCollection>]
[-ClearPermissions]
[-Confirm]
[-DisplayName <String>]
[-Email <String>]
[-Group <SPGroupPipeBind>]
[-IsSiteCollectionAdmin]
[-PassThru]
[-RemovePermissionLevel <String[]>]
[-SyncFromAD]
[-Web <SPWebPipeBind>]
[-WhatIf]
[<CommonParameters>]Description
Cmdlet Set-SPUser 會設定現有使用者的屬性。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
------------------範例 1-----------------------
Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -AddPermissionLevel "Contributor"本範例會將 Contoso\jdoe) (使用者設定為 上的 https://intranet.contoso.com 參與者。
------------------範例 2-----------------------
Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -SyncFromAD這會以使用者 Active Directory 帳戶的目前 displayName 和 mail 屬性值，更新使用者 'contoso\jdoe' 的使用者資訊清單。
參數
-AddPermissionLevel
指定要新增至使用者的許可權等級。
值必須是下列其中一個選項：
--貢獻
可以檢視、新增、更新和刪除清單專案和檔。
--設計
可以檢視、新增、更新、刪除、核准和自訂檔。
--Full Control
可完全控制所有檔。
--Limited Access
授與許可權時，可以檢視特定清單、文件庫、清單專案、資料夾或檔。
--讀
可以檢視頁面和清單專案，以及下載檔案。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AssignmentCollection
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 Global 參數時，所有物件會包含在全域儲存區內。
如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ClearPermissions
從使用者刪除所有指派的許可權。 如果存在 Clear 和 Add 值，則會先清除許可權，然後新增新的許可權。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Confirm
在執行命令之前，提示您確認操作。
如需詳細資訊，請輸入下列命令：get-help about_commonparameters。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DisplayName
指定使用者的新顯示名稱。
類型必須是有效的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
指定使用者的新電子郵件地址。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Group
將使用者新增至指定網站中的現有群組。
| Type: | SPGroupPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Identity
指定要傳回之使用者的 GUID、登入名稱或 SPUser 物件。
此類型必須是格式為 1234-5678-9876-0987 之現有使用者的 GUID。
| Type: | SPUserPipeBind |
| Aliases: | UserAlias |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-IsSiteCollectionAdmin
指定是否要將使用者設定為網站集合管理員。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-PassThru
如果未提供，表示此 Cmdlet 沒有輸出。 如果提供，此參數會指出要傳回此使用者的 SPUser 物件。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-RemovePermissionLevel
從使用者移除許可權等級。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SyncFromAD
如果提供，則指定要從使用者目錄存放區同步處理使用者資訊。 此參數只會從目錄存放區擷 displayName 取 和 mail 值。 它支援 Active Directory (傳統或Windows 驗證) 、表單型驗證和 SAML。 FBA 和 SAML 提供者必須支援從其目錄存放區解析，此參數才能運作。 參數僅支援 SharePoint 使用者物件。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Web
指定要當做範圍使用的 URL 或 GUID 名稱。 如果提供 SPUser 物件做為身分識別，則不需要此參數。
此值必須是格式為 的驗證 URL https://server_name ，或格式為 1234-5678-9807 的 GUID。
| Type: | SPWebPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WhatIf
顯示訊息會描述命令的功效而不執行命令。
如需詳細資訊，請輸入下列命令：get-help about_commonparameters。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |