New-SPUser
將現有的使用者新增至具有指定權限的 SharePoint 網站。
Syntax
New-SPUser
[-UserAlias] <String>
-Web <SPWebPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-DisplayName <String>]
[-Email <String>]
[-Group <SPGroupPipeBind>]
[-PermissionLevel <String[]>]
[-SiteCollectionAdmin]
[-WhatIf]
[<CommonParameters>]Description
Cmdlet New-SPUser 會將現有的使用者新增至具有指定許可權的 SharePoint 網站。
此使用者在所有繼承許可權的子網站中都有指定的許可權。
使用者帳戶必須已經存在於使用者目錄中。
如果您的環境處於 Active Directory 模式，則使用者必須已經存在於 Active Directory 網域服務 (AD DS) ，而且只需要 UserAlias 參數;所有其他欄位都會從 AD DS 提取。 如果只指定別名，且伺服器陣列處於 Active Directory 帳戶建立模式，則也需要 Email 參數。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
------------------範例 1----------------------
New-SPUser -UserAlias 'Contoso\Jdow'-DisplayName 'Jane Dow' -Web https://contoso.com本範例會將名為 Jane Dow 的新使用者新增至 Contoso 網域。
------------------EXAMPLE 2----------------------
Get-SPWeb https://sitename | New-SPUser -UserAlias Contoso\Jdow本範例會將 Contoso\Jdow 新增至網站集合中 https://sitename 的所有網站。 因為此網站集合使用繼承的權限，所以只需要處理最上層的網站。
參數
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-DisplayName
指定包含使用者顯示名稱的字串。
此類型必須是有效的使用者名稱，例如「喬治」。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
指定新使用者的電子郵件地址。
此類型必須是格式為 的有效電子郵件地址 someone@contoso.com 。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Group
指定新使用者所屬的使用者群組。
| Type: | SPGroupPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-PermissionLevel
將使用者新增至權限層級。
此類型必須是 Web 應用程式的有效權限層級，例如 Full Control 、 Read 、 Contribute 或 All 。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SiteCollectionAdmin
指定是否要將使用者新增為網站集合的管理員。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-UserAlias
指定 ACTIVE DIRECTORY 網域服務 (AD DS) 中的使用者別名。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Web
指定此使用者建立所在的網路 URL 或 GUID。
此類型必須是格式為 https://server_name 的有效 URL，或格式為 1234-5678-9876-0987 的 GUID。
| Type: | SPWebPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |