Get-SPAppInstance

앱 인스턴스의 메타데이터를 반환합니다.

Syntax

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>]

Description

이 cmdlet에는 둘 이상의 매개 변수 집합이 포함됩니다. 한 매개 변수 집합의 매개 변수만 사용할 수 있으며 서로 다른 매개 변수 집합의 매개 변수를 결합하면 안 됩니다. 매개 변수 세트를 사용하는 방법에 대한 자세한 내용은 Cmdlet 매개 변수 세트를 참조하세요.

Get-AppInstance cmdlet을 사용하여 SPWeb 개체에 대해 설치되는 응용 프로그램 인스턴스 컬렉션을 가져옵니다.

SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 SharePoint Server Cmdlets를 참조하세요.

예제

---------------예제 1---------------

Get-SPAppInstance -Web https://localhost

이 예제에서는 둘 이상의 앱이 설치된 경우 컬렉션을 반환합니다 https://localhost. 앱이 하나만 설치되면 단일 개체가 반환됩니다.

---------------예제 2---------------

Get-SPAppInstance -AppInstanceId $instance.Id

다음은 앱 인스턴스의 ID를 반환하는 예제입니다.

매개 변수

-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

-Site

쿼리 범위를 사이트로 설정합니다.

하위 사이트도 포함되지 않습니다.

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

-웹

SPWeb 개체를 지정합니다.

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