Set-SPPeoplePickerConfig
このコマンドレットは、指定した Web アプリケーションのPeopleピッカーの設定を設定します。
構文
Set-SPPeoplePickerConfig
-WebApplication <SPWebApplicationPipeBind>
[-ActiveDirectoryCustomFilter <String>]
[-ActiveDirectoryCustomQuery <String>]
[-ActiveDirectorySearchTimeout <Int32>]
[-PeopleEditorOnlyResolveWithinSiteCollection]
[-OnlySearchWithinSiteCollection]
[-NoWindowsAccountsForNonWindowsAuthenticationMode]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このSet-SPPeoplePickerConfigコマンドレットは、指定した Web アプリケーションのPeopleピッカーの次の設定を設定します。1) ピッカー クエリを使用して AD に送信されるカスタマイズされたクエリ フィルター People設定します。 2) Peopleピッカー クエリを使用して AD に送信されるカスタマイズされたクエリ。 3) AD 検索がタイムアウトするまでの時間。4) [名前の確認] ボタンをクリックしたときに、People ピッカー コントロールがサイト コレクション ユーザーのみを返す必要があるかどうか。 5) [Peopleピッカー] コントロールが [Peopleとグループの選択] ダイアログ ボックスを使用する場合にのみサイト コレクション ユーザーを返す必要があるかどうか。 6) Web アプリケーションがフォーム ベースの認証を使用する場合に、Active Directory 以外のユーザーのみを返すかどうか。
例
------------- 例 1 -------------
Set-SPPeoplePickerConfig -WebApplication http://MyOfficeApp1 -ActiveDirectoryCustomFilter "((Title=Manager))" -ActiveDirectoryCustomQuery (sn={0}*) -ActiveDirectorySearchTimeout 60 -PeopleEditorOnlyResolveWithinSiteCollection -OnlySearchWithinSiteCollection -NoWindowsAccountsForNonWindowsAuthenticationMode次の使用例は、次の設定を Web アプリケーション MyOfficeApp1 のPeopleピッカーに設定します。 - "マネージャー" のタイトルを持つ Active Directory ユーザーの一覧を返す - クエリは、Active Directory 検索がタイムアウトする 60 秒前に姓のみを検索します。Peopleピッカー コントロールは、[名前の確認] ボタンをクリックした場合にのみサイト コレクション ユーザーを返す必要があります - People ピッカー コントロールは、[Peopleとグループの選択] ダイアログ ボックスを使用する場合にのみサイト コレクション ユーザーを返す必要があります- People ピッカー コントロールは、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
People ピッカー クエリに Active Directory に追加されたライトウェイト ディレクトリ アクセス プロトコル (LDAP) クエリ文字列。
| 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 オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
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
コマンドレットを実行する前に確認メッセージを表示します。
| 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 以外のユーザーのみが返すPeopleピッカー コントロールを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-OnlySearchWithinSiteCollection
[Peopleとグループの選択] ダイアログ ボックスを使用する場合にのみ、Peopleピッカー コントロールがサイト コレクション ユーザーを返す必要があることを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-PeopleEditorOnlyResolveWithinSiteCollection
[名前の確認] ボタンをクリックした場合にのみサイト コレクション ユーザーを返す必要があるPeopleピッカー コントロールを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WebApplication
ピッカーの設定People設定する 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
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 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 |