Поделиться через

Get-SPAppInstance

  • Ссылка
Модуль:
sharepoint-server
Применяется к:
SharePoint Server Subscription Edition

Возвращает метаданные экземпляра приложения.

Синтаксис

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

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров; использование параметров из разных наборов не допускается. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

Используйте командлет Get-AppInstance, чтобы получить коллекцию экземпляров приложений, установленных в объекте SPWeb.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

-----------ПРИМЕР 1-----------

Get-SPAppInstance -Web https://localhost

Этот пример возвращает коллекцию, если в ней установлено несколько приложений. https://localhost. Если установлено только одно приложение, возвращается один объект.

-----------ПРИМЕР 2-----------

Get-SPAppInstance -AppInstanceId $instance.Id

В этом примере возвращается идентификатор экземпляра приложения.

Параметры

-App

Указывает приложение.

Этот параметр возвращает метаданные для всех экземпляров приложения.

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

-AppInstanceId

Указывает идентификатор экземпляра приложения для отображения.

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

-AssignmentCollection

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

Если применяется параметр 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

-Identity

Указывает экземпляр приложения, для которого требуется найти метаданные.

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

-Site

Задает область запроса для сайта.

Дочерние сайты не включены.

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

-Web

Указывает объект SPWeb.

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