Get-SPAppInstance
Retorna os metadados para uma instância de um aplicativo.
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
Este cmdlet contém mais de um conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.
Use o cmdlet Get-AppInstance para obter um conjunto de instâncias do aplicativo que estão instaladas em um objeto SPWeb.
Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.
Exemplos
-----------EXEMPLO 1-----------
Get-SPAppInstance -Web https://localhost
Este exemplo retornará uma coleção se mais de um aplicativo estiver instalado no https://localhost. Se apenas um aplicativo está instalado, um único objeto é retornado.
-----------EXEMPLO 2-----------
Get-SPAppInstance -AppInstanceId $instance.Id
Este exemplo retorna o ID de uma instância de um aplicativo.
Parâmetros
-App
Especifica o aplicativo.
Este parâmetro retorna metadados para todas as instâncias de um aplicativo.
Type: | SPApp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-AppInstanceId
Especifica a ID do aplicativo a ser exibida.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-AssignmentCollection
Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.
Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Identity
Especifica a instância do aplicativo na qual deve-se localizar metadados.
Type: | SPAppInstance |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Site
Define um escopo de consulta para um site.
Os subsites não são incluídos.
Type: | SPSitePipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Web
Especifica o objeto SPWeb.
Type: | SPWebPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |