New-SPUser
適用版本： SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間： 2015-03-09
將現有的使用者新增至具有指定權限的 SharePoint 網站。
Syntax
New-SPUser [-UserAlias] <String> -Web <SPWebPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-Email <String>] [-Group <SPGroupPipeBind>] [-MobileNumber <String>] [-PermissionLevel <String[]>] [-SiteCollectionAdmin <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
New-SPUser Cmdlet 會將現有的使用者新增至具有指定權限的 SharePoint 網站。此使用者擁有繼承權限之全部子網站的指定權限。使用者目錄中必須已有此使用者帳戶。
您的環境若處於 Active Directory 模式中，此使用者必須已存在於 Active Directory 網域服務 (AD DS) 中，而且只需要 UserAlias 參數，所有其他檔案都會提取自 AD DS。若僅指定一個別名，且伺服器陣列處於 Active Directory 建立帳戶模式中，則也需要 Email 參數。
如需 Windows PowerShell for SharePoint 產品的權限及最新資訊，請參閱線上說明文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 參數 | 必要 | 輸入 | 描述 |
|---|---|---|---|
UserAlias |
必要 |
System.String |
|
Web |
必要 |
Microsoft.SharePoint.PowerShell.SPWebPipeBind |
指定此使用者建立所在的網路 URL 或 GUID。 此類型必須是格式為 http://server_name 的有效 URL，或格式為 1234-5678-9876-0987 的 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 |
DisplayName |
選用 |
System.String |
指定包含使用者顯示名稱的字串。 此類型必須是有效的使用者名稱，例如「喬治」。 |
選用 |
System.String |
指定新使用者的電子郵件地址。 此類型必須是格式為 someone@example.com 的有效電子郵件地址。 |
|
Group |
選用 |
Microsoft.SharePoint.PowerShell.SPGroupPipeBind |
指定新使用者所屬的使用者群組。 |
MobileNumber |
選用 |
System.String |
指定新使用者的電子郵件地址。 此類型必須是格式為 someone@example.com 的有效電子郵件地址。 |
PermissionLevel |
選用 |
System.String[] |
將使用者新增至權限原則層級。 此類型必須是使用者的有效權限原則層級，例如 Full、Read、Contribute 或 All。 |
SiteCollectionAdmin |
選用 |
System.Management.Automation.SwitchParameter |
指定是否要將使用者新增為網站集合的管理員。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
輸入類型
傳回類型
Example
------------------範例 1----------------------
PS> New-SPUser - UserAlias 'Contoso\Jdoe'-displayname 'John Doe' -web https://contoso.com
此範例會將新使用者 John Doe 新增至 Contoso 網域。
------------------範例 2----------------------
Get-SPWeb http://sitename | New-SPUser -UserAlias Contoso\Jdoe
此範例會將 Contoso\Jdoe 新增至 http://sitename 網站集合的所有網站。因為此網站集合使用繼承的權限，所以只需要處理最上層的網站。