Get-SPAppInstance
Возвращает метаданные экземпляра приложения.
Синтаксис
IdentityParameterSet
Get-SPAppInstance
-Identity <SPAppInstance>
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
SiteAndIdParameterSet
Get-SPAppInstance
-Site <SPSitePipeBind>
-AppInstanceId <Guid>
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
WebParameterSet
Get-SPAppInstance
-Web <SPWebPipeBind>
[-App <SPApp>]
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
Описание
Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров; использование параметров из разных наборов не допускается. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.
Используйте командлет Get-AppInstance, чтобы получить коллекцию экземпляров приложений, установленных в объекте SPWeb.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
ПРИМЕР 1
Get-SPAppInstance -Web https://localhost
Этот пример возвращает коллекцию, если в ней установлено несколько приложений. https://localhost. Если установлено только одно приложение, возвращается один объект.
ПРИМЕР 2
Get-SPAppInstance -AppInstanceId $instance.Id
В этом примере возвращается идентификатор экземпляра приложения.
Параметры
-App
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает приложение.
Этот параметр возвращает метаданные для всех экземпляров приложения.
Свойства параметра
| Тип: | SPApp |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
WebParameterSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AppInstanceId
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает идентификатор экземпляра приложения для отображения.
Свойства параметра
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
SiteAndIdParameterSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AssignmentCollection
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.
Свойства параметра
| Тип: | SPAssignmentCollection |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает экземпляр приложения, для которого требуется найти метаданные.
Свойства параметра
| Тип: | SPAppInstance |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
IdentityParameterSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Site
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Задает область запроса к сайту.
Дочерние сайты не включены.
Свойства параметра
| Тип: | SPSitePipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
SiteAndIdParameterSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Web
Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает объект SPWeb.
Свойства параметра
| Тип: | SPWebPipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
WebParameterSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.