Get-SPAppInstance

Gibt die Metadaten für eine Instanz einer App zurück.

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

Beschreibung

Das Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.

Verwenden Sie das Get-AppInstance-Cmdlet, um eine Auflistung der App-Instanzen abzurufen, die in einem SPWeb-Objekt installiert sind.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

-----------BEISPIEL 1-----------

Get-SPAppInstance -Web https://localhost

In diesem Beispiel wird eine Auflistung zurückgegeben, wenn mehr als eine App auf https://localhostinstalliert ist. Wenn nur eine einzige App installiert ist, wird in einziges Objekt zurückgegeben.

-----------BEISPIEL 2-----------

Get-SPAppInstance -AppInstanceId $instance.Id

In diesem Beispiel wird die ID einer Instanz einer App zurückgegeben.

Parameter

-App

Gibt die App an.

Dieser Parameter gibt Metadaten für alle Instanzen einer App zurück.

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

-AppInstanceId

Gibt die App-Instanz-ID an, die angezeigt werden soll.

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

Gibt die App-Instanz an, für die Metadaten gefunden werden sollen.

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

-Web

Gibt das SPWeb-Objekt an.

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

-Website

Legt den Abfragebereich auf eine Website fest.

Unterwebsites werden nicht einbezogen.

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