Set-SPPeoplePickerConfig

參考

模組:: sharepoint-server

適用於:: SharePoint Server Subscription Edition

此 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