Set-SPUser

  • 參考
模組:
SharePointServer
適用於:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

設定現有使用者的屬性。

Syntax

Set-SPUser
   [-Identity] <SPUserPipeBind>
   [-AddPermissionLevel <String[]>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-ClearPermissions]
   [-Confirm]
   [-DisplayName <String>]
   [-Email <String>]
   [-Group <SPGroupPipeBind>]
   [-IsSiteCollectionAdmin]
   [-PassThru]
   [-RemovePermissionLevel <String[]>]
   [-SyncFromAD]
   [-Web <SPWebPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

Cmdlet Set-SPUser 會設定現有使用者的屬性。

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。

範例

------------------範例 1-----------------------

Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -AddPermissionLevel "Contributor"

本範例會將 Contoso\jdoe) (使用者設定為 上的 https://intranet.contoso.com 參與者。

------------------範例 2-----------------------

Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -SyncFromAD

這會以使用者 Active Directory 帳戶的目前 displayName 和 mail 屬性值，更新使用者 'contoso\jdoe' 的使用者資訊清單。

參數

-AddPermissionLevel

指定要新增至使用者的許可權等級。

值必須是下列其中一個選項：

--貢獻

可以檢視、新增、更新和刪除清單專案和檔。

--設計

可以檢視、新增、更新、刪除、核准和自訂檔。

--Full Control

可完全控制所有檔。

--Limited Access

授與許可權時，可以檢視特定清單、文件庫、清單專案、資料夾或檔。

--讀

可以檢視頁面和清單專案，以及下載檔案。

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

-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

-ClearPermissions

從使用者刪除所有指派的許可權。 如果存在 Clear 和 Add 值，則會先清除許可權，然後新增新的許可權。

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

-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

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

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

-Identity

指定要傳回之使用者的 GUID、登入名稱或 SPUser 物件。

此類型必須是格式為 1234-5678-9876-0987 之現有使用者的 GUID。

Type:SPUserPipeBind
Aliases:UserAlias
Position:1
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

-IsSiteCollectionAdmin

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

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

-PassThru

如果未提供，表示此 Cmdlet 沒有輸出。 如果提供，此參數會指出要傳回此使用者的 SPUser 物件。

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

-RemovePermissionLevel

從使用者移除許可權等級。

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

-SyncFromAD

如果提供，則指定要從使用者目錄存放區同步處理使用者資訊。 此參數只會從目錄存放區擷 displayName 取 和 mail 值。 它支援 Active Directory (傳統或Windows 驗證) 、表單型驗證和 SAML。 FBA 和 SAML 提供者必須支援從其目錄存放區解析，此參數才能運作。 參數僅支援 SharePoint 使用者物件。

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

-Web

指定要當做範圍使用的 URL 或 GUID 名稱。 如果提供 SPUser 物件做為身分識別，則不需要此參數。

此值必須是格式為 的驗證 URL https://server_name ，或格式為 1234-5678-9807 的 GUID。

Type:SPWebPipeBind
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

-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