Get-SPAppInstance

アプリケーションのインスタンスのメタデータを返します。

構文

Get-SPAppInstance
   -Identity <SPAppInstance>
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]
Get-SPAppInstance
   -Site <SPSitePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   -AppInstanceId <Guid>
   [<CommonParameters>]
Get-SPAppInstance
   [-App <SPApp>]
   [-AssignmentCollection <SPAssignmentCollection>]
   -Web <SPWebPipeBind>
   [<CommonParameters>]

説明

このコマンドレットには、複数のパラメーター セットが含まれています。 使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。 パラメーター セットの使用法に関する詳しい情報については、「コマンドレットのパラメーター セット」を参照してください。

Get-AppInstance コマンドレットは、SPWeb オブジェクトにインストールされているアプリケーション インスタンスのコレクションを取得します。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

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

Get-SPAppInstance -Web https://localhost

この例では、複数のアプリがインストールされている場合にコレクションを https://localhost返します。 アプリケーションが 1 つしかインストールされていない場合は、単一のオブジェクトが返されます。

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

Get-SPAppInstance -AppInstanceId $instance.Id

この例では、アプリケーションのインスタンスの ID を取得します。

パラメーター

- Site

クエリ範囲をサイトに設定します。

サブサイトは含められません。

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

-App

アプリを指定します。

このパラメーターでは、アプリケーションのすべてインスタンスのメタデータが返されます。

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

-AppInstanceId

表示するアプリ インスタンス ID を指定します。

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

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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

-Identity

どのアプリケーション インスタンスのメタデータを探すかを指定します。

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

-Web

SPWeb オブジェクトを指定します。

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