Remove-SPUser
適用版本： SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間： 2015-03-09
移除網站的使用者。
Syntax
Remove-SPUser [-Identity] <SPUserPipeBind> -Web <SPWebPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Group <SPGroupPipeBind>] [-WhatIf [<SwitchParameter>]]
詳細描述
Remove-SPUser Cmdlet 會指定要從中移除使用者的身分識別及使用者群組。Remove-SPUser Cmdlet 不會移除 Active Directory 網域服務 (AD DS) 中的使用者。
如需 Windows PowerShell for SharePoint 產品的權限及最新資訊，請參閱線上說明文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 參數 | 必要 | 輸入 | 描述 |
|---|---|---|---|
Identity |
必要 |
Microsoft.SharePoint.PowerShell.SPUserPipeBind |
指定要移除的 GUID、使用者名稱或 SPUser 物件。 此類型必須是格式為 1234-5678-9876-0987 的有效使用者 GUID。 |
Web |
必要 |
Microsoft.SharePoint.PowerShell.SPWebPipeBind |
指定要從中移除使用者的 URL 名稱或 GUID。只有當提供的身分識別為使用者名稱時，才需要此參數。 此類型必須是格式為 http://server_name 的有效 URL，或格式為 1234-5678-9807 的 GUID。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
Group |
選用 |
Microsoft.SharePoint.PowerShell.SPGroupPipeBind |
只會將使用者從群組中移除。否則，就是將使用者從網站中移除。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
輸入類型
傳回類型
Example
------------------範例 1-----------------------
Remove-SPUser "Contoso \jdoe" -web https://test/web1
Get-SPWeb "https://test/web1" | Remove-SPUser "Contoso\jdoe"
此範例會從 Web 應用程式 https://test/web1 移除使用者 (Contoso\jdoe)。
------------------範例 2-----------------------
Get-SPSite https://contoso.com |Get-SPWeb |Remove-SPUser "Contoso\jdoe"
此語法會從位於 https://contoso.com 之網站集合的每個網路中，移除使用者 (Contoso\Jdoe)。