LDAP 検索のスコープを指定します。このプロパティは、検索がサブツリー全体（BaseDN およびすべての下の階層）、単一のレベル（BaseDN および、直接の子階層）、もしくはベースオブジェクトのみ（BaseDN のみ）のいずれに適用されるかを定義します。

Syntax

Connect-LDAP -Scope string

Possible Values

Data Type

cstr

Default Value

"WHOLESUBTREE"

Remarks

このプロパティは、パフォーマンスとクエリ結果のバランスをとるのに役立ちます。 ディレクトリ階層全体のエントリを取得する必要がある幅広い検索には、WHOLESUBTREE を使用します。 より焦点を絞ったクエリには、SINGLELEVEL を選択して結果をBaseDN の直接の子階層に限定するか、BASEOBJECT を選択してBaseDN 自体だけを取得します。 検索スコープを狭めることで、不必要なオーバーヘッドを減らし、特に大きなディレクトリでのクエリ効率を向上させることができます。

• WHOLESUBTREE（デフォルト）： BaseDN およびすべての子階層を検索します。
• SINGLELEVEL： BaseDN および1つ下の子階層のみを検索します。
• BASEOBJECT： 子階層含めずに、BaseDN 自身だけを検索します。

This is a required parameter.