Get-SPFeature
特定のスコープに基づいて SharePoint 機能を返します。
構文
FarmFeatures
Get-SPFeature
[[-Identity] <SPFeatureDefinitionPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Farm]
[-Limit <String>]
[<CommonParameters>]
SiteFeatures
Get-SPFeature
[[-Identity] <SPFeatureDefinitionPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Limit <String>]
[-Site <SPSitePipeBind>]
[-Sandboxed]
[<CommonParameters>]
WebFeatures
Get-SPFeature
[[-Identity] <SPFeatureDefinitionPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Limit <String>]
[-Web <SPWebPipeBind>]
[<CommonParameters>]
WebApplicationFeatures
Get-SPFeature
[[-Identity] <SPFeatureDefinitionPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Limit <String>]
[-WebApplication <SPWebApplicationPipeBind>]
[<CommonParameters>]
FarmFeatureDefinitions
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
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
パラメーターのプロパティ
| 型: | SPAssignmentCollection |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CompatibilityLevel
該当: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
新しい SPSite オブジェクトを作成するとき、使用するテンプレートのバージョンを指定します。 この値は、サイト コレクションの CompatibilityLevel の初期値を設定します。 このパラメーターを指定しないと、CompatibilityLevel は、CompatibilityRange の設定に応じて、Web アプリケーションで指定できる最高のバージョンに既定で設定されます。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FarmFeatureDefinitions
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Farm
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
このパラメーターを使用した場合は、有効になっているファームの機能だけを表示するように指定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FarmFeatures
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
取得する機能の名前を指定します。
取得する機能の型は、Feature1 形式の完全名または一部名、または GUID 形式の 1234-4567-9879 である必要があります。
パラメーターのプロパティ
| 型: | SPFeatureDefinitionPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Limit
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
表示結果を制限します。 "All" を指定した場合は、すべての機能が表示されます。
この型は、0 よりも大きい有効な数であることが必要です。 既定値は 200 です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Sandboxed
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
サンドボックス機能を取得することを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SiteFeatures
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Site
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
有効になっている機能を取得するサイト コレクションの名前を指定します。
この型は、http://<サーバー名> という形式の、サイト コレクションの有効な URL であることが必要です。
パラメーターのプロパティ
| 型: | SPSitePipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SiteFeatures
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Web
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
Web の URL または GUID を指定します。
この型は、http://<サーバー名> という形式の有効な URL であるか、1234-5678-9876-0987 という形式の GUID であることが必要です。
パラメーターのプロパティ
| 型: | SPWebPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WebFeatures
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WebApplication
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
有効になっている機能を取得する Web アプリケーションの名前を指定します。
この型は、http://<サーバー名> という形式の、Web アプリケーションへの有効な URL であることが必要です。
パラメーターのプロパティ
| 型: | SPWebApplicationPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WebApplicationFeatures
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。