Set-SPPeoplePickerConfig
此 Cmdlet 會設定指定 Web 應用程式人員選擇器的設定。
Syntax
Set-SPPeoplePickerConfig
-WebApplication <SPWebApplicationPipeBind>
[-ActiveDirectoryCustomFilter <String>]
[-ActiveDirectoryCustomQuery <String>]
[-ActiveDirectorySearchTimeout <Int32>]
[-PeopleEditorOnlyResolveWithinSiteCollection]
[-OnlySearchWithinSiteCollection]
[-NoWindowsAccountsForNonWindowsAuthenticationMode]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此Set-SPPeoplePickerConfig Cmdlet 會設定指定 Web 應用程式人員選擇器的下列設定:1) 使用人員選擇器查詢傳送至 AD 的自訂查詢篩選器。 2) 使用 人員 選擇器查詢傳送至 AD 的自訂查詢。 3) AD 搜尋逾時之前的時間量。4) 人員選擇器控制項在按一下 [檢查名稱] 按鈕時,是否應該只傳回網站集合使用者。 5) 使用 [選取人員和群組] 對話方塊時,人員選擇器控制項是否應該只傳回網站集合使用者。 6) Web 應用程式使用表單型驗證時,是否只傳回非 Active Directory 使用者。
範例
-------------範例 1-------------
Set-SPPeoplePickerConfig -WebApplication http://MyOfficeApp1 -ActiveDirectoryCustomFilter "((Title=Manager))" -ActiveDirectoryCustomQuery (sn={0}*) -ActiveDirectorySearchTimeout 60 -PeopleEditorOnlyResolveWithinSiteCollection -OnlySearchWithinSiteCollection -NoWindowsAccountsForNonWindowsAuthenticationMode
本範例會將下列設定設為 Web 應用程式 MyOfficeApp1 的人員選擇器:- 傳回標題為 「Manager」 的 Active Directory 使用者清單 - 查詢只會搜尋姓氏 - Active Directory 搜尋逾時前 60 秒 - 人員選擇器控制項應該只會在按一下 [檢查名稱] 按鈕時傳回網站集合使用者 - 人員 選擇器控制項應該只在使用 [選取人員和群組] 對話方塊時傳回網站集合使用者 - 當 Web 應用程式使用表單型驗證時,人員選擇器控制項只會傳回非 Active Directory 使用者
參數
-ActiveDirectoryCustomFilter
輕量型目錄存取通訊協定 (LDAP) 查詢字串,以建立用來顯示查詢結果的自訂篩選。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-ActiveDirectoryCustomQuery
輕量型目錄存取通訊協定 (LDAP) 附加至 active Directory 人員選擇器查詢的查詢字串。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-ActiveDirectorySearchTimeout
Active Directory 搜尋逾時之前的秒數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-NoWindowsAccountsForNonWindowsAuthenticationMode
指定當 Web 應用程式使用表單型驗證時,人員選擇器控制項只會傳回非 Active Directory 使用者。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-OnlySearchWithinSiteCollection
指定使用 [選取人員和群組] 對話方塊時,人員選擇器控制項應該只傳回網站集合使用者。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-PeopleEditorOnlyResolveWithinSiteCollection
指定人員選擇器控制項應該只在按一下 [檢查名稱] 按鈕時傳回網站集合使用者。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-WebApplication
要設定人員選擇器設定的 Web 應用程式。
Type: | SPWebApplicationPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 未執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |