Get-FASTSearchMetadataCrawledProperty
適用先: SharePoint Server 2010
トピックの最終更新日: 2015-03-09
Microsoft FAST Search Server 2010 for SharePoint からクロールされたプロパティを取得します。
Syntax
Get-FASTSearchMetadataCrawledProperty [[-Name] <String>] [-Count <Nullable>] [-Filter <String>] [-Offset <Nullable>]
詳細説明
このコマンドレットでは、クロールされたプロパティを FAST Search Server 2010 for SharePoint システムから取得します。パラメーターを指定せずに呼び出した場合、システム内のクロールされたプロパティがすべて取得されます。取得されるクロールされたプロパティの順序は決まっていて、クロールされたプロパティが新たに追加されない限り、何度呼び出しても同じ順序で列挙されたプロパティのリストが取得されます。
注意
このコマンドレットは、一致する 1 つ以上のクロールされたプロパティを取得します。1 つのクロールされたプロパティに正確に一致させるには、代わりに、Set-FASTSearchMetadataCrawledproperty を使用します。Set-FASTSearchMetadataCrawledProperty を使用する直接参照のほうが Get-FASTSearchMetadataCrawledProperty を使用する参照よりも効率的です。
Get-FASTSearchMetadataCrawledProperty には、プロパティの検索方法が複数サポートされています。パラメーターを 1 つだけ指定するか、名前付きパラメーター (Name) を指定してこのコマンドレットを実行した場合、指定した名前と完全に一致するクロールされたプロパティが (存在する場合は) 取得されます。Name パラメーターには、ワイルドカードを使用できます。クロールされたプロパティを検索するもう 1 つの方法は、Filter パラメーターを使ってフィルターを指定する方法です。その場合は、名前にフィルター値が含まれるクロールされたプロパティがすべて取得されます。フィルター オプションにワイルドカードは使用できません。
クロールされたプロパティを取得する方法としては、Filter パラメーターを使う方が Name パラメーターを使うよりも効率的です。
このコマンドレットの一連の結果を画面単位に出力するには、Offset および Count を使用して、取得する結果の件数を制御します。
注意
Offset と Count は、フィルターまたは名前による照合が完了する前に計算されます。つまり、クロールされたプロパティが [Offset,Offset+Count] の範囲に収まらなかった場合、それらのプロパティは取得されません。
Parameters
パラメーター | 必須/省略可 | 型 | 説明 |
---|---|---|---|
Name |
省略可 |
System.String |
取得するクロールされたプロパティの名前。 Name パラメーターには、ワイルドカードを使用できます。検索範囲は、Name パラメーターに Offset パラメーターと Count パラメーターを組み合わせることによって制御します。 |
Count |
省略可 |
System.Nullable |
クロールされたプロパティの最大取得件数。クロールされたプロパティの取得件数は、最初に取得したプロパティを 1 件目とするか、または、Offset パラメーターで指定したインデックスを 1 件目として数えます。 Filter パラメーターまたは Name パラメーターを指定した場合は、結果セットが [Offset, Offset + Count] の範囲に絞り込まれた後で適用されます。 |
Filter |
省略可 |
System.String |
構成済みのクロールされたプロパティを検索するための用語。 Filter パラメーターにワイルドカードは使用できません。照合では大文字と小文字は区別されず、クロールされたプロパティの name 属性内の任意の文字列が照合の対象となります。 |
Offset |
省略可 |
System.Nullable |
結果セット内の結果を取得する起点となるオフセット位置。 |
入力値の型
戻り値の型
Example
--------------- 例 1 -----------------
Get-FASTSearchMetadataCrawledProperty
パラメーターを指定せずに Get-FASTSearchMetadataCrawledProperty を呼び出すと、FAST Search Server 2010 for SharePoint システム内の既知のクロールされたプロパティがすべて取得されます。
--------------- 例 2 -----------------
Get-FASTSearchMetadataCrawledProperty -Name viewurl
この例では、名前が "viewurl" と完全に一致するクロールされたプロパティを取得します。
--------------- 例 3 -----------------
Get-FASTSearchMetadataCrawledProperty -filter 4
この例では、名前に "4" が含まれるクロールされたプロパティをすべて取得します。
--------------- 例 4 -----------------
Get-FASTSearchMetadataCrawledproperty -filter url -count 2
この例では、名前が "url" であるクロールされたプロパティのうち、最初の 2 件を取得します。
--------------- 例 5 -----------------
Get-FASTSearchMetadataCrawledproperty |ForEach-Object{ if ($_.IsMappedToContents) {$_.Name} }
この例では、IsMappedToContents パラメーターが "true" に設定されているすべてのクロールされたプロパティの名前を取得します。まず、構成済みのクロールされたプロパティをすべて取得し、それらを繰り返し処理しながら、IsMappedToContents が "true" に設定されているものを探します。
--------------- 例 6 -----------------
Get-FASTSearchMetadataCrawledproperty -offset 0 -count 2
Get-FASTSearchMetadataCrawledproperty -offset 2 -count 2
Get-FASTSearchMetadataCrawledproperty -offset 4 -count 2
この例では、コマンドレットを実行するたびに 2 つのクロールされたプロパティのリストを生成します。Offset を Count の値だけ増やしながら、前回の終了位置から、クロールされたプロパティを取得します。
--------------- 例 7 -----------------
Get-FASTSearchMetadataCrawledProperty -filter url| where-object {($_.Name -eq "url") -and ($_.VariantType -eq 31) -and ($_.Propset -eq "63e90878-0292-490d-8b7c-f3905a8b65fd")}
この例では、特定の名前と一致する可能性のあるクロールされたプロパティをすべて表示します。次に、その結果セットを繰り返し処理して完全に一致するものを選択し、要求されたプロパティ セットと一致して、バリアント型でもある結果を取り出します。このコマンドは、"Enterprise Crawler" カテゴリ内の "url" というクロールされたプロパティを取得します。
See Also
Reference
New-FASTSearchMetadataCrawledProperty
Set-FASTSearchMetadataCrawledProperty