New-SPUser

模組:: SharePointServer module

將現有的使用者新增至具有指定權限的 SharePoint 網站。

語法

Default (預設值)

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 模式，使用者必須已存在於 AD DS) Active Directory 網域服務 (且只需要 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 網域。

範例 2

Get-SPWeb https://sitename | New-SPUser -UserAlias Contoso\Jdow

本範例會將 Contoso\Jdow 新增至網站集合中的所有 https://sitename Web。因為此網站集合使用繼承的權限，所以只需要處理最上層的網站。

參數

-AssignmentCollection

管理物件以適當處置它們。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。

使用 Global 參數時，所有物件會包含在全域儲存區內。如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。

參數屬性

類型:	SPAssignmentCollection
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行命令之前，提示您確認操作。如需詳細資訊，請輸入下列命令：get-help about_commonparameters。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	CF

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DisplayName

指定包含使用者顯示名稱的字串。

此類型必須是有效的使用者名稱，例如「喬治」。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Email

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

類型必須是有效的電子郵件地址，在表單 someone@contoso.com中。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Group

指定新使用者所屬的使用者群組。

參數屬性

類型:	SPGroupPipeBind
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PermissionLevel

將使用者新增至權限層級。

此類型必須是 Web 應用程式的有效權限層級，例如 Full Control 、 Read 、 Contribute 或 All 。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SiteCollectionAdmin

指定是否要將使用者新增為網站集合的管理員。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-UserAlias

指定 AD DS) Active Directory 網域服務 (使用者別名。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Web

指定此使用者建立所在的網路 URL 或 GUID。

此類型必須是格式為 https://server_name 的有效 URL，或格式為 1234-5678-9876-0987 的 GUID。

參數屬性

類型:	SPWebPipeBind
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示訊息會描述命令的功效而不執行命令。如需詳細資訊，請輸入下列命令：get-help about_commonparameters。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	WI

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

意見反應

此頁面對您有幫助嗎？