Get-SPFeature

リファレンス

モジュール:: sharepoint-server

適用対象:: SharePoint Server Subscription Edition

特定のスコープに基づいて SharePoint 機能を返します。

構文

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Farm]
   [-Limit <String>]
   [<CommonParameters>]

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Limit <String>]
   [-Site <SPSitePipeBind>]
   [-Sandboxed]
   [<CommonParameters>]

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Limit <String>]
   [-Web <SPWebPipeBind>]
   [<CommonParameters>]

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Limit <String>]
   [-WebApplication <SPWebApplicationPipeBind>]
   [<CommonParameters>]

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Limit <String>]
   [-CompatibilityLevel <Int32>]
   [<CommonParameters>]

説明

このコマンドレットには、複数のパラメーターセットが含まれています。

使用できるのは、1 つのパラメーターセットのパラメーターだけであり、異なるパラメーターセットのパラメーターを組み合わせることはできません。パラメーターセットの使用方法の詳細については、「コマンドレットパラメーターセット https://go.microsoft.com/fwlink/?LinkID=18781」を参照してください。

すべてのパラメーターセットでは Identity パラメーターとして、SharePoint 機能の相対パス (機能名として解釈される) または機能定義の GUID を指定できます。

Identity パラメーターを指定した場合は、指定した範囲から指定した機能定義またはインスタンスが取得されます。パラメーターを指定しない場合は、インストールされているすべての機能が取得されます。

Get-SPFeature コマンドレットの動作は範囲ごとに異なり、各レベルで有効になっている機能を取得します。範囲を指定しない場合は、インストールされているすべての機能が取得されます。

SharePoint 製品のWindows PowerShellに関するアクセス許可と最新の情報については、のオンラインドキュメントを参照してくださいhttps://go.microsoft.com/fwlink/p/?LinkId=251831。

例

-------------- 例 1 -----------------

Get-SPFeature -Limit ALL | Where-Object {$_.Scope -eq "SITE"}

この例では、SITE の範囲にインストール済みのすべての機能を一覧表示します。

-------------- 例 2 -----------------

Get-SPSite https://somesite | Get-SPWeb -Limit ALL |%{ Get-SPFeature -Web $_ } | Select DisplayName,ID -Unique

次の使用例は、サイトコレクション内のすべての SPWeb オブジェクトで一意に有効になっている各機能の名前と識別子 (ID) を返します。 https://somesite.

パラメーター

-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

-CompatibilityLevel

新しい SPSite オブジェクトを作成するとき、使用するテンプレートのバージョンを指定します。この値は、サイトコレクションの CompatibilityLevel の初期値を設定します。このパラメーターを指定しないと、CompatibilityLevel は、CompatibilityRange の設定に応じて、Web アプリケーションで指定できる最高のバージョンに既定で設定されます。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Farm

このパラメーターを使用した場合は、有効になっているファームの機能だけを表示するように指定します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identity

取得する機能の名前を指定します。

取得する機能の型は、Feature1 形式の完全名または一部名、または GUID 形式の 1234-4567-9879 である必要があります。

Type:	SPFeatureDefinitionPipeBind
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Limit

表示結果を制限します。 "All" を指定した場合は、すべての機能が表示されます。

この型は、0 よりも大きい有効な数であることが必要です。既定値は 200 です。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Sandboxed

サンドボックス機能を取得することを指定します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Site

有効になっている機能を取得するサイトコレクションの名前を指定します。

この型は、http://<サーバー名> という形式の、サイトコレクションの有効な URL であることが必要です。

Type:	SPSitePipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Web

Web の URL または GUID を指定します。

この型は、http://<サーバー名> という形式の有効な URL であるか、1234-5678-9876-0987 という形式の GUID であることが必要です。

Type:	SPWebPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WebApplication

有効になっている機能を取得する Web アプリケーションの名前を指定します。

この型は、http://<サーバー名> という形式の、Web アプリケーションへの有効な URL であることが必要です。

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

次の方法で共有