Set-SPUser

模組:: SharePointServer module

設定現有使用者的屬性。

語法

Default (預設值)

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

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

如需適用於 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

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

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

--貢獻

可以檢視、新增、更新和刪除清單項目和文件。

--設計

可以查看、添加、更新、刪除、批准和自定義文檔。

--完全控制

擁有所有文件的完整控制權。

--有限存取

可以在授與權限時檢視特定清單、文件庫、清單項目、資料夾或文件。

--閱讀

可以檢視頁面和清單項目以及下載文件。

參數屬性

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

參數集

(All)

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

-AssignmentCollection

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

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

參數屬性

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

參數集

(All)

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

-ClearPermissions

刪除使用者所有指派的權限。如果存在 [清除] 和 [新增值]，則會先清除權限，然後再新增新的權限。

參數屬性

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

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	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

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

參數屬性

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

參數集

(All)

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

-Group

將使用者新增至指定網站中的現有群組。

參數屬性

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

參數集

(All)

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

-Identity

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

類型必須是 1234-5678-9876-0987 表單中現有使用者的 GUID。

參數屬性

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

參數集

(All)

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

-IsSiteCollectionAdmin

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

參數屬性

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

參數集

(All)

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

-PassThru

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

參數屬性

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

參數集

(All)

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

-RemovePermissionLevel

移除使用者的權限等級。

參數屬性

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

參數集

(All)

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

-SyncFromAD

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

參數屬性

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

參數集

(All)

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

-Web

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

該值必須是真實的 URL，表單 https://server_name為，或 GUID，格式為 1234-5678-9807。

參數屬性

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

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	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。

意見反應

此頁面對您有幫助嗎？