New-SPUser

參考

模組:: SharePointServer

適用於:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

將現有的使用者新增至具有指定權限的 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

-Email

指定新使用者的電子郵件地址。

此類型必須是格式為的有效電子郵件地址 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